2 db2 universal database for z/os - 無料ホームページ …¬¬77 章-stop ddf (db2) 433 第78...

DB2® DB2 Universal Database for z/OS

コマンド解説書

バージョン 8

SC88-9809-03(英文原典：SC18-7416-04)

��

ご注意本書および本書で紹介する製品をご使用になる前に、 477ページの『特記事項』に記載されている情報をお読みください。

このソフトコピー・バージョンは、同資料のハードコピー版に基づいており、ハードコピー版に垂直バーで示されている変更内容を含みます。ハードコピー版の公開以降、本書のソフトコピー版に行われた追加の変更内容は、左余白にハッシュ (#) 記号で示してあります。技術的に重要でない編集上の変更には、縦線は付けられていません。

IBM 発行のマニュアルに関する情報のページ

http://www.ibm.com/jp/manuals/

こちらから、日本語版および英語版のオンライン・ライブラリーをご利用いただけます。また、マニュアルに関するご意見やご感想を、上記ページよりお送りください。今後の参考にさせていただきます。

(URL は、変更になる場合があります)

お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示されたりする場合があります。

　原　典： SC18–7416–04

DB2 Universal Database for z/OS

Command Reference

Version 8

　発　行：日本アイ・ビー・エム株式会社

　担　当：ナショナル・ランゲージ・サポート

第1刷 2007.5

この文書では、平成明朝体™W3、平成明朝体™W7、平成明朝体™W9、平成角ゴシック体™W3、平成角ゴシック体™

W5、および平成角ゴシック体™W7を使用しています。この(書体*)は、（財）日本規格協会と使用契約を締結し使用しているものです。フォントとして無断複製することは禁止されています。

　　注* 平成明朝体™W3、平成明朝体™W7、平成明朝体™W9、平成角ゴシック体™W3、平成角ゴシック体™W5、平成角ゴシック体™W7

© Copyright International Business Machines Corporation 1982, 2007. All rights reserved.

© Copyright IBM Japan 2007

目次

本書について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

本書における変更の要約 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

第 1 部特権、許可 ID、およびバインド処理. . . . . . . . . . . . . . . . . . . 1

第 1 章特権および許可 ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

第 2 章バインド処理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

第 2 部コマンドの処理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

第 3 章 DB2 コマンドの構文解析 . . . . . . . . . . . . . . . . . . . . . . . . . 9

第 4 章コマンドの有効範囲 . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

第 5 章 DB2 コマンドからの出力 . . . . . . . . . . . . . . . . . . . . . . . . 15

第 6 章 IFI から DB2 へのコマンドの発行 . . . . . . . . . . . . . . . . . . . . . 17

第 7 章 DSN サブコマンドの構文解析. . . . . . . . . . . . . . . . . . . . . . . 19

第 8 章コマンドの説明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

第 3 部コマンド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

第 9 章 -ALTER BUFFERPOOL (DB2) . . . . . . . . . . . . . . . . . . . . . . 29

第 10 章 -ALTER GROUPBUFFERPOOL (DB2) . . . . . . . . . . . . . . . . . . 37

第 11 章 -ALTER UTILITY (DB2) . . . . . . . . . . . . . . . . . . . . . . . . 43

第 12 章 -ARCHIVE LOG (DB2) . . . . . . . . . . . . . . . . . . . . . . . . . 47

第 13 章 BIND PACKAGE (DSN) . . . . . . . . . . . . . . . . . . . . . . . . 55

第 14 章 BIND PLAN (DSN) . . . . . . . . . . . . . . . . . . . . . . . . . . 63

第 15 章 BIND および REBIND オプション . . . . . . . . . . . . . . . . . . . . 69

第 16 章 -CANCEL THREAD (DB2) . . . . . . . . . . . . . . . . . . . . . . . 107

第 17 章 /CHANGE (IMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

第 18 章 DCLGEN (DECLARATIONS GENERATOR) (DSN) . . . . . . . . . . . . 115

第 19 章 /DISPLAY (IMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

第 20 章 -DISPLAY ARCHIVE (DB2) . . . . . . . . . . . . . . . . . . . . . . 129

© Copyright IBM Corp. 1982, 2007 iii

第 21 章 -DISPLAY BUFFERPOOL (DB2) . . . . . . . . . . . . . . . . . . . . 131

第 22 章 -DISPLAY DATABASE (DB2) . . . . . . . . . . . . . . . . . . . . . 141

第 23 章 -DISPLAY DDF (DB2) . . . . . . . . . . . . . . . . . . . . . . . . 161

第 24 章 -DISPLAY FUNCTION SPECIFIC (DB2) . . . . . . . . . . . . . . . . . 165

第 25 章 -DISPLAY GROUP (DB2) . . . . . . . . . . . . . . . . . . . . . . . 171

第 26 章 -DISPLAY GROUPBUFFERPOOL (DB2) . . . . . . . . . . . . . . . . . 177

第 27 章 -DISPLAY LOCATION (DB2). . . . . . . . . . . . . . . . . . . . . . 191

第 28 章 -DISPLAY LOG (DB2) . . . . . . . . . . . . . . . . . . . . . . . . 195

第 29 章 -DISPLAY PROCEDURE (DB2) . . . . . . . . . . . . . . . . . . . . 197

第 30 章 -DISPLAY RLIMIT (DB2) . . . . . . . . . . . . . . . . . . . . . . . 203

第 31 章 -DISPLAY THREAD (DB2). . . . . . . . . . . . . . . . . . . . . . . 205

第 32 章 -DISPLAY TRACE (DB2) . . . . . . . . . . . . . . . . . . . . . . . 221

第 33 章 -DISPLAY UTILITY (DB2) . . . . . . . . . . . . . . . . . . . . . . . 229

第 34 章 DSN (TSO) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

第 35 章 DSNC (CICS 接続機能) . . . . . . . . . . . . . . . . . . . . . . . . 239

第 36 章 DSNC DISCONNECT (CICS 接続機能) . . . . . . . . . . . . . . . . . 241

第 37 章 DSNC DISPLAY (CICS 接続機能). . . . . . . . . . . . . . . . . . . . 243

第 38 章 DSNC MODIFY (CICS 接続機能) . . . . . . . . . . . . . . . . . . . . 249

第 39 章 DSNC STOP (CICS 接続機能) . . . . . . . . . . . . . . . . . . . . . 253

第 40 章 DSNC STRT (CICS 接続機能) . . . . . . . . . . . . . . . . . . . . . 255

第 41 章 DSNH (TSO CLIST) . . . . . . . . . . . . . . . . . . . . . . . . . 257

第 42 章 END (DSN) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

第 43 章 FREE PACKAGE (DSN) . . . . . . . . . . . . . . . . . . . . . . . 293

第 44 章 FREE PLAN (DSN). . . . . . . . . . . . . . . . . . . . . . . . . . 297

第 45 章 MODIFY irlmproc,ABEND (z/OS IRLM) . . . . . . . . . . . . . . . . . 299

第 46 章 MODIFY irlmproc,DIAG (z/OS IRLM) . . . . . . . . . . . . . . . . . . 301

第 47 章 MODIFY irlmproc,PURGE (z/OS IRLM) . . . . . . . . . . . . . . . . . 305

第 48 章 MODIFY irlmproc,SET (z/OS IRLM) . . . . . . . . . . . . . . . . . . 307

iv コマンド解説書

第 49 章 MODIFY irlmproc,STATUS (z/OS IRLM). . . . . . . . . . . . . . . . . 313

第 50 章 -MODIFY TRACE (DB2). . . . . . . . . . . . . . . . . . . . . . . . 321

第 51 章 REBIND PACKAGE (DSN) . . . . . . . . . . . . . . . . . . . . . . 325

第 52 章 REBIND PLAN (DSN). . . . . . . . . . . . . . . . . . . . . . . . . 329

第 53 章 REBIND TRIGGER PACKAGE (DSN) . . . . . . . . . . . . . . . . . . 335

第 54 章 -RECOVER BSDS (DB2) . . . . . . . . . . . . . . . . . . . . . . . 339

第 55 章 -RECOVER INDOUBT (DB2) . . . . . . . . . . . . . . . . . . . . . . 341

第 56 章 -RECOVER POSTPONED (DB2) . . . . . . . . . . . . . . . . . . . . 345

第 57 章 -RESET GENERICLU (DB2) . . . . . . . . . . . . . . . . . . . . . . 349

第 58 章 -RESET INDOUBT (DB2) . . . . . . . . . . . . . . . . . . . . . . . 351

第 59 章 RUN (DSN) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

第 60 章 -SET ARCHIVE (DB2) . . . . . . . . . . . . . . . . . . . . . . . . 359

第 61 章 -SET LOG (DB2). . . . . . . . . . . . . . . . . . . . . . . . . . . 363

第 62 章 -SET SYSPARM (DB2) . . . . . . . . . . . . . . . . . . . . . . . . 367

第 63 章 SPUFI (DSN) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

第 64 章 /SSR (IMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

第 65 章 /START (IMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

第 66 章 -START DATABASE (DB2) . . . . . . . . . . . . . . . . . . . . . . 375

第 67 章 -START DB2 (DB2) . . . . . . . . . . . . . . . . . . . . . . . . . 385

第 68 章 -START DDF (DB2) . . . . . . . . . . . . . . . . . . . . . . . . . 389

第 69 章 -START FUNCTION SPECIFIC (DB2) . . . . . . . . . . . . . . . . . . 391

第 70 章 START irlmproc (z/OS IRLM) . . . . . . . . . . . . . . . . . . . . . 395

第 71 章 -START PROCEDURE (DB2) . . . . . . . . . . . . . . . . . . . . . 401

第 72 章 -START RLIMIT (DB2) . . . . . . . . . . . . . . . . . . . . . . . . 405

第 73 章 -START TRACE (DB2) . . . . . . . . . . . . . . . . . . . . . . . . 407

第 74 章 /STOP (IMS). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419

第 75 章 -STOP DATABASE (DB2) . . . . . . . . . . . . . . . . . . . . . . . 421

第 76 章 -STOP DB2 (DB2) . . . . . . . . . . . . . . . . . . . . . . . . . . 429

目次 v

第 77 章 -STOP DDF (DB2) . . . . . . . . . . . . . . . . . . . . . . . . . . 433

第 78 章 -STOP FUNCTION SPECIFIC (DB2) . . . . . . . . . . . . . . . . . . 437

第 79 章 STOP irlmproc (z/OS IRLM). . . . . . . . . . . . . . . . . . . . . . 441

第 80 章 -STOP PROCEDURE (DB2) . . . . . . . . . . . . . . . . . . . . . . 443

第 81 章 -STOP RLIMIT (DB2) . . . . . . . . . . . . . . . . . . . . . . . . . 447

第 82 章 -STOP TRACE (DB2) . . . . . . . . . . . . . . . . . . . . . . . . . 449

第 83 章 -TERM UTILITY (DB2) . . . . . . . . . . . . . . . . . . . . . . . . 455

第 84 章 /TRACE (IMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459

第 85 章 TRACE CT (z/OS IRLM) . . . . . . . . . . . . . . . . . . . . . . . 461

第 4 部付録 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

サブシステム・パラメーターのディレクトリー . . . . . . . . . . . . . . . . . . . 467

DB2 ライブラリーの使用方法 . . . . . . . . . . . . . . . . . . . . . . . . . . 473

特記事項. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477

用語集 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481

参考文献. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523

索引 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

vi コマンド解説書

本書について

本書は、システム管理者、データベース管理者、およびアプリケーション・プログラマーが使用する数多くのコマンドをリストした解説書です。コマンドは、即時に検索ができるようにアルファベット順に記載してあります。

重要本バージョンの DB2 UDB for z/OS には、オプショナル製品として DB2

Utilities Suite があります。これらのユーティリティーは別途注文して購入する必要があります。本書でこのようなユーティリティー機能について説明していても、これらのユーティリティーに対する使用を許諾していることを意図するものではありません。パッケージ化の詳細については「DB2 ユーティリティー・ガイドおよび解説書」の第 1 部を参照してください。

本書の対象読者本書には、システム管理、データベース管理、および操作に携わる担当者が参照される情報が記載されています。さらに、コマンドについての詳細な情報を、構文、オプションの説明、および各コマンドの例なども含めて、記載しています。

本書の規則および用語DB2® コマンド固有の命名規則については『命名規則』で解説します。用語については xiページの『用語と引用について』で解説します。

命名規則SQL ステートメントによって作成されたオブジェクト (表、表スペース、索引など)

をパラメーターで参照する場合、SQL 構文命名規則に従います。

この節では、コマンド固有の命名規則について説明します。文字は、英文字、数字、そして特殊文字に分類されます。

v 英文字とは、英大文字 A から Z (米国では、各国語用の英字拡張文字として予約されている #、@、および $ の 3 文字を含む) のいずれかのことです。

v 数字とは、0 ～ 9 の任意の文字のことです。

v 特殊文字とは、英文字または数字以外の文字のことです。

ID についてさらに説明が必要な場合は、「DB2 SQL 解説書」第 2 章を参照してください。

authorization-id

1 ～ 128 個の英文字、数字、または下線からなる ID で、一連の特権を識別します。許可 ID の先頭には英文字を指定する必要があります。

© Copyright IBM Corp. 1982, 2007 vii

|

|

collection-id

1 ～ 128 個の英文字、数字、または下線からなる SQL ID で、パッケージのコレクションを識別します。そのため、コレクション ID はパッケージ ID の修飾子となります。コレクション ID の先頭には英文字を指定する必要があります。

コレクション ID の先頭には DSN を指定しないでください。DB2 提供のコレクション ID と競合する可能性があります。DSN から始まるコレクション ID

を指定すると、DB2 が警告メッセージを出します。

connection-name

1 ～ 8 文字の ID で、DB2 へのアドレス・スペース接続を識別します。接続ID は以下のいずれか 1 つです。

v TSO フォアグラウンドで実行する DSN 処理の場合には、接続名 TSO が使用されます。

v TSO バッチで実行する DSN 処理の場合には、接続名 BATCH が使用されます。

v 呼び出し接続機能 (CAF) の場合には、接続名 DB2CALL が使用されます。

v リソース・リカバリー・サービス接続機能 (RRSAF) の場合には、接続名RRSAF が使用されます。

v IMS および CICS 処理の場合には、接続名はシステム識別名です。

接続名についての詳細は、「DB2 管理ガイド」第 4 部 (第 1 巻) を参照してください。

correlation-id

1 ～ 12 文字の ID で、アドレス・スペース接続内の処理を識別します。相関ID の先頭には英文字を指定する必要があります。

相関 ID は以下のいずれかになります。

v TSO フォアグラウンドで実行する DSN 処理の場合、相関 ID は TSO ログオン ID です。

v TSO バッチで実行する DSN 処理の場合、相関 ID はジョブ名です。

v CAF 処理の場合、相関 ID は TSO ログオン ID です。

v RRSAF 処理の場合、相関 ID はサインオン時に指定した値です。

v IMS 処理の場合、相関 ID は pst#.psbname です。

v CICS 処理の場合、相関 ID は identifier.thread_number.transaction_identifier です。

相関 ID についての詳細は、「DB2 管理ガイド」第 4 部 (第 1 巻) を参照してください。

data-set-name

1 ～ 44 文字の ID で、データ・セットを識別します。

dbrm-member-name

1 ～ 8 個の英文字または数字の ID で、区分データ・セットのメンバーを識別します。(MVS™ ではこの命名規則が必要となります。)

viii コマンド解説書

|

DBRM メンバーの先頭には DSN を指定しないでください。DB2 提供のDBRM メンバー名と競合する可能性があるからです。DSN で始まる DBRM メンバー名を指定すると、DB2 は警告メッセージを出します。

dbrm-pds-name

1 ～ 44 文字の ID で、区分データ・セットを識別します。

ddname

1 ～ 8 文字の ID で、DD ステートメントの名前を指定します。

hexadecimal-constant

一連の数字または A ～ F の任意の文字 (大文字または小文字)。

hexadecimal-string

X に続いて、アポストロフィで始まりアポストロフィで終わる一連の文字。ストリング区切り文字に挟まれた文字は、16 進数でなければなりません。

ip address (またはインターネット・アドレス)

4-byte バイトで構成される値で、TCP/IP ネットワーク内の TCP/IP ホストを固有に識別します。IP アドレスは、通常は、ドット表記と呼ばれる形式で表示されます。この場合、IP アドレスの各バイトは 10 進数形式で表示され、各数字はピリオドで区切られます。

location-name

1 ～ 16 文字の英文字 (英字拡張文字を除く)、数字または下線からなるロケーション ID。データベース管理システムのインスタンスを識別します。ロケーション名の先頭には英文字を指定する必要があります。

luname

1 ～ 8 文字の SQL ID で、論理装置名を識別します。 luname の先頭には英文字を指定する必要があります。

luwid

完全修飾された LU ネットワーク名および LUW インスタンス番号。

LU ネットワーク名は、8 文字からなるオプションのネットワーク ID、ピリオド、そして 8 文字のネットワーク LU 名で構成されます。ネットワーク ID を指定しない場合、ピリオドは不要です。LUW インスタンス番号は、作業単位を固有に識別する 12 個の 16 進数文字で構成されます。

member-name

1 ～ 8 文字の ID で、区分データ・セットのメンバー (オペレーティング・システムではこの命名規則が必要となります) とデータ共用グループのメンバーのいずれかを識別します。

区分データ・セットのメンバー名の先頭には DSN を指定しないでください。DB2 提供のメンバー名と競合する可能性があります。DSN から始まる名前を指定すると、DB2 が警告メッセージを出します。

package-id

1 ～ 8 個の英文字、数字、または下線からなる SQL ID で、パッケージを識別します。DB2 のもとで作成されたパッケージの場合、プリコンパイルによってそのパッケージの DBRM を作成したプログラムの名前がパッケージ ID となります。パッケージ ID の先頭には英文字を指定する必要があります。(オペレーティング・システムではこの命名規則が必要となります。)

本書について ix

|

|

パッケージ ID の先頭には DSN を指定しないでください。DB2 提供のパッケージ ID と競合する可能性があります。DSN で始まるパッケージ ID を指定すると、DB2 が警告メッセージを出します。

トリガー・パッケージの場合は、パッケージ ID がトリガー名です。トリガー名は、1 ～ 128 個の英文字、数字、または下線からなる SQL ID で、トリガー・パッケージを識別します。

package-name

単一パッケージのバインド処理中に作成されたオブジェクトに与えられる名前。パッケージ名はロケーション名、コレクション ID、およびパッケージ ID で構成されており、それらはピリオドで区切られています。さらに追加の属性 (バージョン ID) により、パッケージの複数のバージョンが同じ名前を持つことができます。

plan-name

1 ～ 8 個の英文字、数字、または下線からなる SQL ID で、アプリケーション・プランを識別します。プラン名の先頭には英文字を指定する必要があります。

プラン名の先頭には DSN を指定しないでください。DB2 提供のプラン名との矛盾が生じることがあります。DSN から始まるプラン名を指定すると、DB2 が警告メッセージを出します。

qualifier-name

1 ～ 128 個の英文字、数字、または下線からなる SQL ID で、修飾されていない表名、ビュー、索引、および別名への暗黙の修飾子を識別します。

string

アポストロフィで始まりアポストロフィで終わる一連の文字。

subsystem-name

オペレーティング・システムに認識されている通りに DB2 サブシステムを指定する ID。

table-name

表を指定する修飾名または非修飾名。表名にはその修飾に応じて、1 つまたは 2

つの部分が含まれます。最初の部分は、その表の所有者を指定する許可 ID です。さらに 2 番目の部分は SQL ID です。それぞれの部分はピリオドで区切る必要があります。

table-space-name

識別されたデータベースの表スペースを指定する ID。データベースが識別されていない場合、表スペース名はデータベース DSNDB04 の表スペースを指定します。

utility-id

1 ～ 16 文字の ID で、DB2 内のユーティリティー処理を固有に識別します。ユーティリティー ID の先頭には英文字を指定する必要があり、ID にはピリオドを含めることができます。

version-id

1 ～ 64 個の英小文字、英大文字、数字、下線、アットマーク記号 (@)、番号記号 (#)、ドル記号 ($)、ダッシュ、およびピリオドからなる SQL ID で、パッケージの作成時にパッケージに割り当てられます。割り当てられるバージョン

x コマンド解説書

|

|

|

|

|

|

|

ID は、バインドされるプログラムに関連したバージョン ID をもとに決められます。プログラムのバージョン ID は、DB2 プリコンパイルのパラメーターとして指定されます。

用語と引用について本書においては、DB2 Universal Database™ for z/OS® は、「DB2 UDB for z/OS」と表記します。文脈上、意味が明確な場合は、 DB2 UDB for z/OS は「DB2」と表記されています。また、本書でこのライブラリー内の他の資料を言及する場合は、短いタイトルを使用しています。(例えば、「DB2 SQL 解説書」を参照、とは「IBM® DB2 Universal Database for z/OS SQL Reference」を参照せよ、ということです。)

DB2 UDB for z/OS 以外の DB2 製品を参照する場合、本書では、あいまいさを避けるために、その製品の正式名称を使用しています。

以下は用語の解説です。

DB2 DB2 ライセンス・プログラムまたは特定の DB2 サブシステムを示します。

OMEGAMON次の製品を参照します。v IBM Tivoli OMEGAMON XE for DB2 Performance Expert on z/OS

v IBM Tivoli OMEGAMON XE for DB2 Performance Monitor on z/OS

v IBM DB2 Performance Expert for Multiplatforms and Workgroups

v IBM DB2 Buffer Pool Analyzer for z/OS

C、C++、および C 言語C または C++ プログラム言語を示します。

CICS® CICS Transaction Server for z/OS または CICS Transaction Server for

OS/390® を示します。

IMS™ IMS Database Manager または IMS Transaction Manager を示します。

MVS z/OS オペレーティング・システムの MVS エレメントを示します。これは、z/OS オペレーティング・システムの Base Control Program (BCP) コンポーネントと同等です。

RACF®

z/OS セキュリティー・サーバーの RACF コンポーネントが提供する機能を示します。

構文図の読み方本書で使用している構文図には、以下の規則が適用されます。

v 構文図は、左から右へ、上から下へ、線に沿って読んでください。

��─── の記号は、ステートメントの始めを示します。

───� の記号は、ステートメントの構文が次の行に続くことを示します。

�─── の記号は、ステートメントが前の行からの続きであることを示します。

本書について xi

#

#

#

#

#

#

───�� の記号は、ステートメントの終わりを示します。

v 必須項目は横線 (主線) 上に示されています。�� 必須項目 ��

v オプション項目は、主経路の下に示されます。�� 必須項目

オプション項目��

オプション項目が主線より上に示される場合は、その項目はステートメントの実行には影響を与えない項目であり、ステートメントを読みやすくするためにだけ使用されるものです。

��オプション項目

必須項目 ��

v 複数の項目の中から選択できる場合は、それらの項目は縦に並べて示されます。

項目のうちの 1 つを必ず選択しなければならない場合には、並べた項目のうち1 つが主線上に示されます。�� 必須項目必須選択項目 1

必須選択項目 2��

項目のいずれかを選択することがオプションである場合には、項目全体が主線よりも下に示されます。�� 必須項目

オプション項目 1オプション項目 2

��

項目のうちの 1 つがデフォルトである場合には、その項目が主線よりも上に置かれ、その他の選択項目は主線よりも下に置かれます。

�� 必須項目デフォルト選択項目

オプション項目オプション項目

��

v 主線の上を通って左に戻る矢印は、繰り返し指定が可能な項目を示します。

�� 必須項目 � 反復可能項目 ��

繰り返しを示す矢印にコンマが入っている場合には、繰り返し項目をコンマで区切る必要があります。

�� 必須項目 �

,

反復可能項目 ��

縦に並べられた項目の上に繰り返し矢印が示されている場合には、それらの項目を繰り返して指定できることを意味します。

v キーワードは大文字で示されます (FROM など) 。キーワードは示されているとおりに正確に指定しなければなりません。変数はすべて小文字で示されます(column-name など)。これらはユーザー提供の名前あるいは値を表します。

xii コマンド解説書

v なお、構文図に句読記号、括弧、算術演算子、あるいはそれに類する記号が示されている場合は、それらを構文の一部として入力する必要があります。

前提条件および関連情報本書は、DB2 環境におけるシステム管理、データベース管理、またはアプリケーション・プログラミングについて理解している読者が、参照用として利用することを目的としています。読者は、以下についてある程度の知識があることを前提にしています。

v CICS、IMS、または TSO

v z/OS ジョブ制御言語 (JCL)

v 構造化照会言語 (SQL)

DB2 ライブラリーの使用方法については、 473ページの『DB2 ライブラリーの使用方法』を参照してください。

アクセシビリティーアクセシビリティー機能は、運動障害または視覚障害など身体に障害を持つユーザーがソフトウェア・プロダクトを使用できるようにサポートします。DB2 UDB for

z/OS を含む z/OS のアクセシビリティーの主要機能により、ユーザーは以下のことができるようになります。

v スクリーン・リーダー (読み上げソフトウェア) および画面拡大機能などの支援機能の使用

v キーボードのみを使用して、特定の機能または画面を使用した場合と同等の機能を操作

v 色、コントラスト、フォント・サイズなど表示属性のカスタマイズ

スクリーン・リーダー (読み上げソフトウェア)などの支援機能は、DB2 UDB for

z/OS のユーザー・インターフェースを使用して機能します。支援機能を使用してこれらのインターフェースにアクセスする場合、支援機能製品の資料を参照し特定の情報を入手してください。

DB2 UDB for z/OS のバージョン 8 に関するオンライン資料は Information

management software for z/OS Solutions インフォメーション・センターより入手できます。これは、スクリーン・リーダー (読み上げソフトウェア) または画面拡大ソフトウェアなどの支援テクノロジーを使用してもアクセスできるフォーマットになっています。Information management software for z/OS Solutions インフォメーション・センターは Web サイト http://publib.boulder.ibm.com/infocenter/dzichelp にあります。

本書について xiii

xiv コマンド解説書

本書における変更の要約

本書の基本的な変更点は、以下のとおりです。

v 以下のコマンドに対して、新しいオプションが使用可能です。

– -DISPLAY DATABASE (DB2)

– DSNH (TSO CLIST)

– MODIFY irlmproc,SET (z/OS IRLM)

– START irlmproc (z/OS IRLM)

v BIND と REBIND PLAN、PACKAGE、および TRIGGER PACKAGE 用のREOPT(VARS) と NOREOPT(VARS) オプションが REOPT(ALWAYS|NONE) に変更されて、3 番目のオプション REOPT(ONCE) が追加されました。

v 以下のコマンドの機能が強化されました。

– -DISPLAY FUNCTION SPECIFIC (DB2)

– -DISPLAY DATABASE (DB2)

– -DISPLAY GROUP (DB2)

– -DISPLAY PROCEDURE (DB2)

– DSNH (TSO CLIST)

– MODIFY irlmproc,SET (z/OS IRLM)

– MODIFY irlmproc,STATUS (z/OS IRLM)

– -SET LOG (DB2)

– -START DATABASE (DB2)

– -STOP DATABASE (DB2)

© Copyright IBM Corp. 1982, 2007 xv

xvi コマンド解説書

第 1 部特権、許可 ID、およびバインド処理

第 1 部では、DB2 で使用する各種コマンド発行時に必要な特権と許可 ID について説明し、バインド処理の概要を紹介します。

© Copyright IBM Corp. 1982, 2007 1

2 コマンド解説書

第 1 章特権および許可 ID

コマンドの発行者は、個々のユーザーである場合があります。さらに、バッチ・モードで実行中のプログラムや、IMS または CICS トランザクションである場合もあります。本書では、処理という語をそのいずれか、あるいはそれらすべてを示すものとして使用しています。

処理は、DB2 に対して ID (ID) のセットによって表されます。DB2 に関して処理が行える内容は、その ID が保持できる特権および権限によって決まります。『処理の特権セット』とは、特定の状況において処理が使用可能な特権および権限のセット全体を本書では意味しています。

ID には、1 次許可 ID、2 次許可 ID、および SQL ID という 3 つのタイプがあります。

v 通常、1 次許可 ID は特定の処理を識別します。例えば、TSO 接続機能によって開始される処理において、1 次許可 ID は TSO ログオン ID と同一です。トレース・レコードは、1 次許可 ID によって処理を識別します。

RACF がアクティブの場合、ログオンされた MVS コンソールまたは TSO SDSF

からコマンドを出す ID が DB2 コマンドに関する適切な RACF 許可を持っているか、または 1 次許可 ID がコマンドを出すための DB2 許可を持っている必要があります。

v 2 次許可 ID はオプションとなっており、処理が利用できる追加の特権を保持させることが可能です。2 次許可 ID は、リソース・アクセス管理機能 (RACF®)

のグループ ID であることがよくあります。例えば、ある処理が、特定データベースへの LOAD 特権を持つ RACF グループに属することができます。グループのメンバーは、LOAD ユーティリティーを実行してデータベースに表スペースをロードすることができます。

ログオンした z/OS コンソールまたは TSO SDSF から出された DB2 コマンドは、1 次または 2 次許可 ID を使用して DB2 許可で検査することができます。

v SQL 許可 ID (SQL ID) には、処理が特定の動的 SQL ステートメントを出すときに使用する特権があります。この ID は、本書で解説している大部分のコマンドには影響を与えません。

DB2 内では、処理は 1 次許可 ID で、場合によってはさらに 1 つ以上の 2 次 ID

で表現することができます。処理を 1 つ以上の ID に関連付ける方法、ならびにそれらの ID に特権を授与する方法について詳しくは、「DB2 管理ガイド」第 3 部(第 1 巻) を参照してください。

ID に対する特権または権限の付与あるいは取り消しは、SQL GRANT またはREVOKE ステートメントを実行することにより行います。これらのステートメントの完全な構文については、「DB2 SQL 解説書」第 5 章を参照してください。


第 2 章バインド処理

バインド処理によって、アプリケーション・プログラムとその関連データ間との関係が確立されます。この処理を行ってからでないと、プログラムを実行することはできません。 DB2 にはプログラムをバインドする方法として、パッケージへのバインド、またはアプリケーション・プランへの直接バインドという 2 つの基本的な方法があります。プログラムが分散データへの DRDA アクセスを使用する場合は、パッケージを使用しなければなりません。

DB2 プリコンパイラーはプリコンパイル処理の間に、修正したソース・コードとデータベース要求モジュール (DBRM) の両方を、アプリケーション・プログラムごとに作成します。そのプログラムを実行するには、修正したソース・コードをコンパイルし、リンク・エディットしておかなければなりません。DBRM は、プランまたはパッケージにバインドする必要があります。

プランの最大サイズを決定する場合は、プランのバインドに要する時間、EDM プールのサイズ、フラグメント化といったいくつかの物理的制約を考慮しなければなりません。プランに組み込める DBRM の数に制限はありません。しかし、パッケージによって、プラン内で多数の DBRM を処理するためのさらに柔軟性のある方法が使用できるようになります。原則として、EDM プールは、最大の DBD またはプランのサイズのいずれか大きい方のサイズの少なくとも 10 倍にする必要があります。詳細については、「DB2 インストレーション・ガイド」第 2 部を参照してください。

BIND PACKAGE サブコマンドを用いると、DBRM を個々にバインドすることができます。このサブコマンドにより、プログラムの異なるバージョンのテストを再バインドを広範囲に行うことなく実行できます。また、リモート・サイトでプログラムをバインドする場合は、パッケージ・バインドが唯一の方法です。

そのプログラムがバインドされてパッケージになっている場合でも、すべてのアプリケーション・プログラムはアプリケーション・プランで指定する必要があります。 BIND PLAN は、DB2 システムとそのプラン内のすべての DBRM またはパッケージとの関係を確立します。プランには、明示的に命名された DBRM、パッケージ、パッケージのコレクション、あるいはこれらのエレメントの組み合わせを指定することができます。指定された DBRM またはパッケージについての情報、さらにアプリケーション・プログラムが使う予定のデータについての情報がそのプランに入れられます。このプランは DB2 カタログに保管されます。

パッケージおよびプランの作成に加えて、バインド処理は以下のタスクを実行します。

v DB2 カタログを使用して SQL ステートメントの妥当性検査。バインド処理の間、DB2 は SQL ステートメントを検査して表名、ビュー名、列名の妥当性を調べます。バインド処理は、プログラム実行前に別のステップとして発生するため、プログラムの実行前にエラーを検出して訂正することができます。

v プログラムのバインド処理が、ご使用のプログラムの SQL ステートメントが要求するデータ・アクセス操作を実行するように、許可されているかどうかの検


査。 BIND を出すときに、プランまたはパッケージの所有者として許可 ID を指定することができます。所有者は、バインドを実行する処理のいずれかの許可 ID

になれます。バインド処理を行うと、プランまたはパッケージの所有者がプログラムが要求するデータにアクセスする許可を得ているかどうかが判別されます。

v プログラム処理に必要な DB2 データにアクセスするために必要なアクセス・パスの選択。 DB2 はアクセス・パス選択の際に、索引、表サイズ、およびその他の要素を考慮します。DB2 はデータのアクセスに利用できるすべての索引を検討し、データへのパス選択時にどの索引 (もしあれば) を使用すればよいかを決定します。

BIND PLAN および BIND PACKAGE は、DB2I パネル、DSNH CLIST またはDSN サブコマンドである BIND PLAN と BIND PACKAGE を用いて行うことができます。DSNH CLIST によるバインドについて詳しくは、『第 3 部コマンド』を参照してください。バインド処理の説明は、「DB2 アプリケーション・プログラミングおよび SQL ガイド」の第 5 部にあります。さらに、BIND に関する詳細は、55ページの『第 13 章 BIND PACKAGE (DSN)』および 63ページの『第 14 章

BIND PLAN (DSN)』に記載されています。BIND PLAN および BIND PACKAGE

に関する具体的なオプションの説明は、 69ページの『第 15 章 BIND およびREBIND オプション』にあります。


第 2 部コマンドの処理

第 2 部では、コマンドの処理について説明します。

21ページの『第 8 章コマンドの説明』の表は、第 3 部に示されているコマンドを要約したものです。各表にはタイプ別コマンドのリスト、その機能の説明、さらに詳細説明が始まる参照ページが記載されています。


第 3 章 DB2 コマンドの構文解析

DB2 コマンドは、図 1 に示されているようなパターンになっています。

以下のトピックには、追加情報が記載されています。

v 『DB2 コマンドの各部分』

v 10ページの『特殊な意味を持つ文字』

v 12ページの『キーワード項目の例』

DB2 コマンドの各部分以下は、コマンドの各部分です。

認識文字本書では、ハイフンとして記載されています。ただし、以下のような例外があります。

v コマンドを z/OS コンソールから入力する場合、認識文字はコマンド接頭部でなければなりません。

DB2 UDB for z/OS バージョン 8 では、コマンド接頭部に最大 8 文字を指定できます。デフォルトは '-DSN1' です。しかし、本書の大部分の例では、このコマンド接頭部がハイフン (-) として定義済みであると想定しています。データ共用グループのメンバーが関係した例では、複数文字によるコマンド接頭部 (-DB1G など) の使用例が示されています。

コマンド接頭部とコマンドの間にスペースを挿入することはオプションです。例えば、以下の形式のどちらでも使用できます。

-DB1GDIS THREAD(*)

-DB1G DIS THREAD(*)

スペースを使用すると、コマンド接頭部が複数の文字で構成される場合などユーザーはコマンドを簡単に識別することができます。

コマンド接頭部はインストール時に定義することができます。詳細については、「DB2 インストレーション・ガイド」第 2 部を参照してください。

図 1. DB2 コマンドの形式と各部分


v コマンドを IMS 端末から入力する場合、この認識文字はコマンド認識文字 (CRC) でなければなりません。このコマンド認識文字は IMS SSM

PROCLIB メンバーで定義されています。詳しくは、「IMS カストマイズの手引き」を参照してください。

v コマンドが CICS 端末から、または DSN コマンド処理プログラムの下で入力される場合、認識文字はハイフンでなければなりません。

コマンド名コマンドの名前。コマンド名には、各コマンドの説明に記載されているように省略形があります。

オペランドコマンドに指定できるキーワードとパラメーターの組み合わせです。

キーワードコマンド・オプションとも呼ばれます。キーワードは、必須の場合もあれば、オプションの場合もあります。キーワードは、コマンドの説明に記載されているとおりに正確に入力しなければなりません。

パラメーターキーワードには、パラメーターを無指定にすることも、1 つ以上指定することもできます。パラメーター・リストがある場合は、それを括弧で囲む必要があります。

分離文字これは 1 つ以上の、ブランクまたはコンマです。左括弧はパラメーター・リストの先頭を示すもので、分離文字は不要です。オプションとして、等号を使用して、括弧を使用せずに単一のパラメーターをそのキーワードから区切ることもできます。

特殊な意味を持つ文字次の文字は、DB2 コマンドの構文において特殊な意味を持ちます。

ブランクは分離文字です。

複数のブランクは、アポストロフィで囲まれたストリングの場合を除き単一ブランクと同等です。

, コンマは分離文字です。

' アポストロフィは、通常使用される SQL ストリング定数区切り文字で、SQL におけるストリング定数の先頭または末尾を示します。(COBOL プログラムの場合に限り、QUOTESQL プリコンパイラー・オプションを用いると引用符を SQL ストリング区切り文字として選ぶことができます。この場合、アポストロフィは SQL エスケープ文字になります。)

ストリング定数内にない英文字は、大文字に変換されます。また、ストリング定数内の 2 つの連続したアポストロフィは 1 個のアポストロフィに変換されます。ストリング定数内のブランク、コンマ、等号、および括弧はリテラル文字として扱われ、分離文字としては認識されません。


英文字の大文字への変換に関する規則には例外があります。CODED

CHARACTER SET オプションがインストール時に 930 または 5026 に設定されると、英文字は SQL ストリング定数内にあるかどうかに関係なく大文字に変換されません。

" 引用符は SQL エスケープ文字で、SQL 区切り ID の先頭または末尾を示します。(COBOL プログラムの場合に限り、QUOTESQL プリコンパイラー・オプションを用いるとアポストロフィを SQL エスケープ文字として選ぶことができます。この場合、二重引用符は SQL ストリング区切り文字になります。)

引用符で区切られているストリング内では、2 つの連続した引用符は 1 つに変換されます。その他の規則は SQL ストリング定数の場合と同じです。

= 等号は、単一パラメーターをキーワードから区切ります。そのため、等号はパラメーターが 1 つしかないキーワードの分離文字として使用されます。また、複数のパラメーターをもつキーワードについても、指定されるパラメーター・リストのメンバーが 1 つだけであれば等号を使用できます。

( 左括弧は、パラメーター・リストの先頭を示します。

) 右括弧は、パラメーター・リストの末尾を示します。

: コロンは、包括の範囲を意味します。例えば、(A:D) は (A,B,C,D) と同じ意味です。また、(1:5) は (1,2,3,4,5) を意味します。コロンは、この操作が特に許されているコマンドの場合に限ってこのような使い方ができます。

* アスタリスクは次の使用法のいずれかを意味します。

* keyword_value に単一のアスタリスクを指定すると、すべてを意味します。例えば、次のようになります。

-DISPLAY UTILITY (*)

*keyword_valuekeyword_value の最初の文字にアスタリスクを使用すると、 * の後に続くすべての文字が同じ場合に、値が一致したと見なされます。例えば、(*BCD)。

keyword*value中間にアスタリスクを使用すると、アスタリスクの前のすべての文字とアスタリスクの後のすべての文字が同じ場合に、値が一致したと見なされます。例えば、(ABC*EFG)。

keyword_value*keyword_value の最後の文字にアスタリスクを使用すると、アスタリスクの前にあるすべての文字が同じ場合に、値が一致したと見なされます。例えば、(ABC*)。

*keyword*_value*ストリングの最初、中間、および最後の文字にアスタリスクを使用することも有効です。例えば、(*BCD*FGH*)。

例えば、DISPLAY UTILITY (*) はすべてのユーティリティーの状況を表示し、DISPLAY UTILITY (R2*) は ID が R2 から始まるすべてのユーティリティーの状況を表示します。

第 3 章 DB2 コマンドの構文解析 11

アスタリスクのパターン・マッチング文字はすべての DB2 コマンドに使用できますが、すべての DB2 コマンドがアスタリスクをサポートするわけではありません。アスタリスクは、パターン・マッチング操作が特に許されているコマンドの場合に限ってこのような使い方ができます。

NO (2 文字のストリング) は、それに続くキーワードを否定します。

否定されたキーワードとは、キーワード自体の反対の意味をもつものでキーワードのデフォルトをオーバーライドするときによく使用します。反対の意味を持たないキーワードの場合 (例えば、NODE のような)、最初の文字「NO」は単にキーワード自体の一部です。

キーワード項目の例以下は、有効なキーワードおよびパラメーターの一般的な例です。v MODE (FORCE)

v MODE=FORCE

v MODE (NOFORCE) (キーワードの否定)

v MODE=NOFORCE (キーワードの否定)

v DATABASE(name1 name2 . . . namen) ACCESS(RO)

v SPACENAM (name1,name2) ACCESS(RO)

v ACCESS (RO),SPACENAM=name

v 上記の組み合わせ

等号の後には複数のパラメーターを指定しないでください。指定するとエラー条件が発生します。


第 4 章コマンドの有効範囲

データ共用環境、コマンドの有効範囲とはそのコマンドの影響範囲です。すべてのコマンドは、以下のいずれかの有効範囲があります。

メンバーまたはローカル多くのコマンドがその発行対象の DB2 サブシステムのみに有効なために、データ共用環境内で使用するこれらのコマンドはメンバーの (またはローカルの) 有効範囲があります。例えば、CANCEL THREAD コマンドは、そのコマンド接頭部で識別されたメンバーに対して指定されたスレッドを取り消します。

グループその他のコマンドはグループの有効範囲があります。それらのコマンドが対象物に影響する方法が、グループのすべてのメンバーに対するのと同じだからです。例えば、グループのいずれかのメンバーから出された STOP

DATABASE コマンドは、そのグループの全メンバーの該当データベースを停止させます。

以下のコマンドは、グループ有効範囲を有しています。

ALTER GROUPBUFFERPOOL (DB2)

BIND PACKAGE (DSN)

BIND PLAN (DSN)

DCLGEN (DSN)

DISPLAY DATABASE (DB2)

DISPLAY GROUP (DB2)

DISPLAY GROUPBUFFERPOOL (DB2)

FREE PACKAGE (DSN)

FREE PLAN (DSN)

MODIFY irlmproc,DIAG (z/OS IRLM)

REBIND PACKAGE (DSN)

REBIND PLAN (DSN)

REBIND TRIGGER PACKAGE (DSN)

START DATABASE (DB2)

STOP DATABASE (DB2)

以下のコマンドは、指定するオプションによってグループまたはメンバーのいずれかの有効範囲を有するものです。

ARCHIVE LOG (DB2)

DISPLAY FUNCTION SPECIFIC (DB2)

DISPLAY PROCEDURE (DB2)

DISPLAY THREAD (DB2)

DISPLAY TRACE (DB2)

DISPLAY UTILITY (DB2)

MODIFY irlmproc,SET (z/OS IRLM)

MODIFY irlmproc,STATUS (z/OS IRLM)

START FUNCTION SPECIFIC (DB2)

START PROCEDURE (DB2)

START TRACE (DB2)

STOP FUNCTION SPECIFIC (DB2)

STOP PROCEDURE (DB2)

STOP TRACE (DB2)

TERM UTILITY (DB2)

他のすべてのコマンドはメンバーの有効範囲を有します。各コマンドの説明には、そのコマンドの有効範囲が含まれています。データ共用の詳細については、「DB2

データ共用: 計画および管理」を参照してください。


第 5 章 DB2 コマンドからの出力

DB2 コマンドから受け取る出力量は、常に 256KB 未満です。受け取ることができる出力の最大量は、次の要因により決まります。

v DB2 サブシステムまたは個々のコマンドが使用できる記憶域量。

v DB2 コマンドを出す環境。

例えば、IMS コンソールから DB2 コマンドを出す場合、32KB を超える出力を受け取ることはできません。

v DISPLAY DATABASE の場合は、LIMIT パラメーターの値。

v DISPLAY THREAD の場合は、出力行数。

DISPLAY THREAD は、254 を超える出力行は表示しません。


第 6 章 IFI から DB2 へのコマンドの発行

IFI を使用して、プログラムから DB2 にコマンドを発行させることを検討してみてください。この方式は、コマンドが成功したか失敗したかの情報をプログラムに戻します。コマンドがゼロ以外の戻りコードを出した場合、プログラムに戻される情報には、処理されたコマンドの診断情報が含まれます。

IFI から DB2 コマンドを実行依頼する方法について詳しくは、「DB2 管理ガイド」付録 E (第 2 巻) を参照してください。


第 7 章 DSN サブコマンドの構文解析

DSN サブコマンドの構文解析は、標準の TSO コマンド構文解析規則に従っています。TSO コマンドの構文解析については、「z/OS TSO/E プログラミング・サービス」を参照してください。

DSN プロセッサー使用時に、サブコマンドを次の行に継続するには、現在行の終わりにハイフン (-) または正符号 (+) を入力してください。正符号を使用する場合、その前に少なくとも 1 つのブランク文字を置き、文字ストリングを行から行へ連結するのを防ぐようにします。正符号を使用すると、TSO/E は継続行にある先行区切り文字 (ブランク、コンマ、タブ、およびコメント) を削除し、そのコマンドの全体サイズが減少することになります。

省略形: DSN コマンドの名前とそのサブコマンドは省略できません。 DB2 の前リリースとの互換性を保つため、省略形が許されているキーワードも一部あります。

推奨事項: 問題発生の可能性を無くすために、キーワードは省略しないでください。


第 8 章コマンドの説明

コマンドは次のように分類されます。v 『DSN コマンドとそのサブコマンド』v 22ページの『DB2 コマンド』v 24ページの『IMS コマンド』v 24ページの『CICS 接続機能コマンド』v 25ページの『z/OS IRLM コマンド』v 26ページの『TSO CLIST』

DSN コマンドとそのサブコマンド環境: DSN は DB2 コマンド・プロセッサーであり、TSO コマンド・プロセッサーとして実行します。そのサブコマンドはすべて (SPUFI を除き) DSN のもとでフォアグラウンドまたはバックグラウンドのいずれかで実行され、END を除くすべてのサブコマンドは DB2 対話機能 (DB2I) 下でも実行されます。SPUFI を実行できるのは、ISPF 下のフォアグラウンドにおいてのみです。

表 1 は、本書で説明している DSN コマンドまたはサブコマンド、その機能、およびコマンドに関する詳しい説明が収録されているページ番号をリストしたものです。

表 1. DSN コマンドとサブコマンド

DSN コマンドまたはサブコマンド機能参照ページ

BIND アプリケーション・パッケージまたはプランを作成する

55, 63

DB2 コマンド DB2 コマンドを実行する 22ページの表 2

DCLGEN (DECLARATIONS GENERATOR) 表またはビューの宣言を作成する

115

DSN DSN セッションを開始する 235

END DSN セッションを終了する 291

FREE アプリケーション・パッケージまたはプランを削除する

293, 297

REBIND アプリケーション・パッケージまたはプランを更新する

325, 329

REBIND

TRIGGER

PACKAGE

アプリケーション・トリガー・パッケージを更新する

335

RUN アプリケーション・プログラムを実行する 355

SPUFI ファイル入力を使用して SQL プロセッサーを実行する

369


DB2 コマンド環境: START DB2 コマンドを入力できるのは、z/OS コンソールからのみです。他のすべての DB2 コマンドは、以下の環境から出すことができます。v z/OS コンソールまたはアプリケーション・プログラムv DSN セッションv DB2I パネルv IMS 端末v CICS 端末v DB2 計測機能インターフェース (IFI) を使用したアプリケーション・プログラム


拡張 MCS コンソール: z/OS の拡張 MCS コンソール機能により、1 つの z/OS システムで 99 台を超えるコンソールを保有できます。 DB2 は拡張 MCS コンソールをサポートしているため、DB2 コマンドから戻されたメッセージは、そのコマンドを出した拡張 MCS コンソールに送られます。拡張 MCS コンソールについて詳しくは、「DB2 管理ガイド第 4 部 (第 1 巻)」および「z/OS MVS 計画: 操作」を参照してください。

表 2 は、各 DB2 コマンド、その機能、およびコマンドに関する詳しい説明が収録されているページ番号をリストしたものです。

表 2. DB2 コマンド

DB2 コマンド機能参照ページ

-ALTER BUFFERPOOL バッファー・プールの属性を更新する 29

-ALTER

GROUPBUFFERPOOL

グループ・バッファー・プールの属性を更新する 37

-ALTER UTILITY REORG ユーティリティーのパラメーター値を更新する

43

-ARCHIVE LOG サイトでの現行アクティブ・ログのクローズ、また次に使用可能なログ・データ・セットのオープンを可能にする

47

-CANCEL THREAD 特定のローカル・スレッドまたは分散スレッドの処理を取り消す

107

-DISPLAY ARCHIVE アーカイブ・ログ処理についての情報を表示する 129

-DISPLAY

BUFFERPOOL

バッファー・プールについての情報を表示する 131

-DISPLAY DATABASE DB2 データベースについての状況情報を表示する 141

-DISPLAY FUNCTION

SPECIFIC

外部ユーザー定義関数についての統計を表示する 165

-DISPLAY GROUP DB2 サブシステムが属するデータ共用グループについての情報を表示する

171

-DISPLAY

GROUPBUFFERPOOL

DB2 グループ・バッファー・プールについての状況情報を表示する

177

-DISPLAY LOCATION 分散スレッドについての状況情報を表示する 191

-DISPLAY LOG オフロード・タスクのログ情報と状況を表示する 195


表 2. DB2 コマンド (続き)


-DISPLAY PROCEDURE ストアード・プロシージャーについての状況情報を表示する

197

-DISPLAY RLIMIT リソース限定機能 (管理プログラム) についての状況情報を表示する

203

-DISPLAY THREAD DB2 スレッドについての情報を表示する 205

-DISPLAY TRACE DB2 トレースについての情報を表示する 221

-DISPLAY UTILITY DB2 ユーティリティーについての状況情報を表示する

229

-MODIFY TRACE 特定のアクティブ・トレースに関連した IFCID

(トレース・イベント) を変更する321

-RECOVER BSDS 重複ブートストラップ・データ・セットを再確立する

339

-RECOVER INDOUBT 未確定のままのスレッドをリカバリーする 341

-RECOVER

POSTPONED

前の再始動中に不完全なままで残されたリカバリー単位のバックアウト処理を完了する

345

-RESET GENERICLU VTAM® によってカップリング・ファシリティーに格納された情報を除去する

349

-RESET INDOUBT -DISPLAY THREAD コマンドで生成される未確定スレッド報告書に表示された情報を除去する

351

-SET ARCHIVE アーカイブ・ログ処理用のテープ装置の割り振りと、テープ装置の割り振り解除時間を制御する

359

-SET LOG チェックポイント頻度を変更する 363

-SET SYSPARM オンラインでサブシステム・パラメーターを変更する

367

-START DATABASE 指定したデータベースを使用可能にする 375

-START DB2 DB2 サブシステムを初期設定する (z/OS コンソールからのみ入力可能)

385

-START DDF 分散データ機能を開始する 389

-START FUNCTION

SPECIFIC

停止されている外部関数をアクティブ化する 391

-START PROCEDURE 停止された、あるいはキャッシュされたストアード・プロシージャーの定義をアクティブ化する

401

-START RLIMIT リソース限定機能 (管理プログラム) を開始する 405

-START TRACE DB2 トレース活動を開始する 407

-STOP DATABASE 指定したデータベースをアプリケーションが使用できないようにする

421

-STOP DB2 DB2 サブシステムを停止する 429

-STOP DDF 分散データ機能を停止する 433

-STOP FUNCTION

SPECIFIC

指定された関数に対する SQL ステートメントの受け入れを停止する

437

-STOP PROCEDURE ストアード・プロシージャーに対する SQL CALL

ステートメントの受け入れを停止する443

-STOP RLIMIT リソース限定機能 (管理プログラム) を停止する 447

第 8 章コマンドの説明 23

表 2. DB2 コマンド (続き)


-STOP TRACE トレース活動を停止する 449

-TERM UTILITY ユーティリティーの実行を終了する 455

完了メッセージ: メッセージ DSN9022I は、DB2 コマンド処理の正常な終了を示すものです。また、DSN9023I は DB2 コマンド処理の異常終了を示します。

IMS コマンド環境: IMS コマンドはいずれも IMS 端末から出すことができます。あるいは、DB2

提供のストアード・プロシージャー DSNAIMS を使用して IMS トランザクションおよびコマンドを起動することもできます。 DSNAIMS について詳しくは、「DB2

管理ガイド」を参照してください。

表 3 は、本書で説明している IMS コマンド、各コマンドの機能、およびコマンドに関する詳しい説明が収録されているページ番号をリストしたものです。

表 3. IMS コマンド

IMS コマンド機能参照ページ

/CHANGE 未確定リカバリー単位をリセットする 113

/DISPLAY IMS と指定のサブシステム (DB2) 間の接続の状況を表示したり、指定のサブシステム (DB2) に関連した未解決のリカバリー単位を表示する

125

/SSR IMS オペレーターによる外部サブシステム (DB2)

コマンドの入力を可能にする371

/START IMS と指定の外部サブシステム (DB2) 間の接続を使用可能にする

373

/STOP アプリケーション・プログラムが外部サブシステム (DB2 の) リソースにアクセスしないようにする

419

/TRACE ユーザーが IMS のトレース活動を指示、制御できるようにする

459

CICS 接続機能コマンド環境: CICS 接続機能コマンドはいずれも CICS 端末から出すことができます。

表 4 は、本書で説明している CICS 接続機能コマンド、各コマンドの機能、および各コマンドに関する詳しい説明が収録されているページ番号をリストしたものです。

表 4. CICS 接続機能コマンド

CICS 接続機能コマンド機能参照ページ

DSNC CICS から DB2 コマンドを入力できるようにする

239

DSNC DISCONNECT スレッドを切断する 241


#

#

#

#

表 4. CICS 接続機能コマンド (続き)

CICS 接続機能コマンド機能参照ページ

DSNC DISPLAY CICS トランザクションについての情報を表示する

243

DSNC MODIFY DB2CONN のメッセージ・キュー宛先を変更する、あるいはプール、DSNC コマンド、またはDB2ENTRY に関連した最大アクティブ・スレッド値を変更する。

249

DSNC STOP CICS 接続機能を停止する 253

DSNC STRT CICS 接続機能を開始する 255

z/OS IRLM コマンド環境: z/OS IRLM コマンドはいずれも z/OS コンソールから入力できます。

表 5 は、本書で説明している各 z/OS IRLM コマンド、各コマンドの機能、および各コマンドに関する詳しい説明が収録されているページ番号をリストしたものです。

表 5. IRLM に影響を与える z/OS コマンド

z/OS コマンド機能参照ページ

MODIFY

irlmproc,ABEND

IRLM を異常終了させる 299

MODIFY irlmproc,DIAG IRLM サブシステムの診断ダンプを開始する 301

MODIFY

irlmproc,PURGE

IRLM 保持ロックを解放する。 305

MODIFY irlmproc,SET さまざまな IRLM 操作パラメーターを動的に設定する。

307

MODIFY

irlmproc,STATUS

IRLM 状況を表示する 313

START irlmproc お客様提供の手順によって IRLM コンポーネントを開始する

395

STOP irlmproc IRLM を正常にシャットダウンする 441

TRACE CT IRLM トレースの開始、停止、修正を行う 461

第 8 章コマンドの説明 25

||||

TSO CLIST表 6 は、TSO CLIST コマンド、各コマンドの機能、および、DSNH の場合、このコマンドに関する詳しい説明が収録されているページ番号をリストしたものです。

表 6. TSO CLIST

CLIST 機能参照ページ

DSNH プログラムの実行を準備し、それが TSO 下で実行するものであれば実行する。また、TSO 下でのフォアグラウンドまたはバックグラウンドにおいて実行する。

257

DSNU DB2 ユーティリティー・ジョブを実行する JCL

を生成する。直接または DB2I を用いて実行可能。このコマンドのプロシージャーについて詳しくは、「DB2 ユーティリティー・ガイドおよび解説書」を参照してください。


第 3 部コマンド

第 3 部では、構文図、意味の説明、規則、およびコマンドの使用例が、アルファベット順のコマンド名で編成されています。


第 9 章 -ALTER BUFFERPOOL (DB2)

DB2 コマンド ALTER BUFFERPOOL は、アクティブまたは非アクティブ・バッファー・プールの属性を更新します。更新値は、更新が再度行われるまで使用されます。

省略形: -ALT BPOOL


v 『環境』

v 『許可』

v 30ページの『構文』

v 30ページの『オプションの説明』

v 33ページの『使用上の注意』

v 34ページの『例』

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

データ共用範囲: メンバー

許可このコマンドを実行するには、次の権限のいずれかを含む処理の特権セットを使用する必要があります。v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限



構文

�� ALTER BUFFERPOOL (bpname)VPSIZE(integer) VPSEQT(integer)

�

�VPPSEQT(integer) VPXPSEQT(integer) DWQT(integer)

�

�VDWQT(integer1,integer2) PGSTEAL( LRU )

FIFO

�

�NO

PGFIX( YES )

��

オプションの説明(bpname)更新するバッファー・プールを指定します。v 4 KB ページのバッファー・プールは、BP0、BP1、...、BP49 と名付けられます。

v 8 KB ページのバッファー・プールは、BP8K0、BP8K1、...、BP8K9 と名付けられます。


v 32 KB ページのバッファー・プールは、BP32K、BP32K1、...、BP32K9 と名付けられます。

VPSIZE (integer)バッファー・プールのサイズを変更します。

integer は、アクティブ・バッファー・プールに割り振るバッファーの数を指定します。

integer は、BP0 以外の 4 KB ページ・バッファー・プールの場合、0 から250000000 までの範囲です。BP0 の場合、その最小値は 2000 です。8 KB ページ・バッファー・プールの場合、値の範囲は 1000 ～ 125000000 です。16

KB ページ・バッファー・プールの場合、範囲は 0 ～ 62500000 です。32 KB

ページ・バッファー・プールの場合、範囲は 0 ～ 31250000 です。

DB2 では、すべてのバッファー・プールに対する合計 VPSIZE が 1 TB に制限されています。このほか、DB2 では、バッファー・プール記憶域の大きさが、z/OS イメージに使用できる実記憶域の約 2 倍に制限されています。

アクティブ・バッファー・プール (BP0 以外) の VPSIZE を 0 に指定すると、DB2 は現行データベースのアクセスおよび、そのバッファー・プールの更新アクティビティーを静止してからバッファー・プールを削除します。そのバッファー・プールに割り当てられた表スペースまたは索引をそれ以後に使用しようとしても失敗します。

-ALTER BUFFERPOOL (DB2)


|

|

|

|

|

|

|

VPSEQT (integer)バッファー・プールの順次スチールしきい値を変更します。

integer には、バッファー・プール用の順次スチールしきい値を指定します。この値は、合計バッファー・プール・サイズに対するパーセントで表現され、有効値の範囲は 0 ～ 100 です。このしきい値は、順次アクセス・パターンの一部であるページ読み取り要求に対するバッファー・プール内バッファーの割り振りに影響します。これには、プリフェッチされるページが含まれます。順次アクセスされるページが入っているバッファー数がこのしきい値を超えると、順次要求は、非順次にアクセスされるページが入ったバッファー以外のこれらバッファーの 1 つを再使用しようとします。初期のデフォルト値は 80 です。

VPSEQT=0 の場合、順次にアクセスされるページは、アクセス・エージェントにより解放された後、バッファー・プール内には保持されません。また、プリフェッチもできません。

VPSEQT=100 であれば、DB2 は非順次バッファー使用を順次バッファー再使用よりも優先します。

VPPSEQT (integer)バッファー・プールの並列順次しきい値を変更します。このしきい値により、並列処理操作に使用されるバッファー・プールの大きさが決まります。

integer には、バッファー・プール用の並列順次しきい値を指定します。この値は順次スチールしきい値のパーセントで表現され、有効値の範囲は 0 ～ 100 です。初期のデフォルト値は 50 です。

VPPSEQT=0 であれば、並列処理操作は使用不可です。

VPXPSEQT (integer)バッファー・プールの支援部分の並列順次しきい値を変更します。このしきい値により、データ共用グループの他のメンバーで発生する照会を処理するために使用するバッファー・プールの部分が決まります。このオプションは、DB2 がデータ共用モードのときだけ有効です。DB2 がデータ共用モードでないときは無視されます。

integer には、バッファー・プールの支援部分の並列順次しきい値を指定します。 integer は、並列順次しきい値 (VPPSEQT) のパーセントで表されます。順次スチールしきい値または並列順次しきい値を変更すると、必ず、並列操作の支援部分専用のバッファー・リソースの割合に直接影響を与えます。有効な値は 0

から 100 までの範囲です。初期のデフォルト値は 0 です。

VPXPSEQT=0 のときは、このバッファー・プールは並列処理を実行している他の DB2 を援助するために使用することはできません。

DWQT (integer)バッファー・プールの据え置き書き出ししきい値を変更します。

integer には、バッファー・プール用の据え置き書き出ししきい値を指定します。この値は、合計バッファー・プール・サイズに対するパーセントで表現され、有効値の範囲は 0 ～ 90 です。このしきい値により、使用できないバッファー数に基づいて、据え置き書き出し開始時期が決まります。使用できないバッファーのカウントがしきい値を超えると、据え置き書き出しが始まります。初期のデフォルト値は 30 パーセントです。


第 9 章 -ALTER BUFFERPOOL (DB2) 31

|

|

|

|

|

|

|

|

|

|

|

|

|

|

VDWQT (integer1,integer2)バッファー・プールの垂直据え置き書き出ししきい値を変更します。

integer1 には、バッファー・プール用の垂直据え置き書き出ししきい値を指定します。 integer1 は、合計バッファー・プール・サイズに対するパーセントで表現され、有効値の範囲は 0 ～ 90 です。

このしきい値は、特定のデータ・セットの更新ページの数に基づいていつ据え置き書き出しを開始するかを判別します。据え置き書き出しは、データ・セット用の更新されたバッファーの数がしきい値を超えた時に、そのデータ・セットに対して開始されます。このしきい値は、DB2 ユーティリティーがアクセスするページ・セットに対してはオーバーライドすることが可能です。また DWQT オプションの値以下でなければなりません。

デフォルト値は 5 パーセントです。値 0 は、データ・セットの更新されたバッファー数が 40 になった時に、32 ページの据え置き書き出しが開始されることを示します。

integer2 には、バッファー・プール用の垂直据え置き書き出ししきい値を指定します。 integer2 はバッファーの絶対数として表されます。integer2 は、大きなバッファー・プール用に低めのしきい値にしたいけれども、integer1 では 0 と1 の integer1 値間の適度な細分性を提供できない場合に使用します。integer2

は integer1 が 0 の場合にのみ適用されます。DB2 は、integer1 に指定された値がゼロでなければ、integer2 の値を無視します。integer2 は 0 ～ 9999 の範囲にできます。デフォルト値は 0 です。

integer1 が 0 で integer2 がゼロでない場合、DB2 は integer2 に指定された値を使用してしきい値を決めます。両方の値が 0 の場合は、integer1 の値 0 がしきい値として使用されます。

PGSTEALDB2 がバッファー・プールに使用するページ・スチール・アルゴリズムを指定します。

初期のデフォルト値は PGSTEAL (LRU) です。しかし、ALTER BUFFERPOOL

コマンドを発行する際、PGSTEAL オプションを使用するときに、LRU またはFIFO のいずれかを明示的に指定する必要があります。

(LRU)LRU (最低使用頻度) アルゴリズムを使用してバッファー・プール・バッファーを管理することを指定します。

(FIFO)FIFO (先入れ先出し法) アルゴリズムを使用してバッファー・プール・バッファーを管理することを指定します。

PGFIXバッファー・プール使用時にそれを実記憶域に固定するかどうかを指定します。

(NO)バッファー・プールを実記憶域に固定しないことを指定します。ページ・バッファーは、各 I/O 操作とグループ・バッファー・プール操作が行われるたびに固定されたり固定解除されたりします。

これはデフォルトです。



|

|

|

|

|

|

|

|

|

|

(YES)バッファー・プールを実記憶域に固定することを指定します。ページ・バッファーは、バッファー・プール割り振りまたは拡張後の最初の使用時に固定されます。

使用上の注意以下のセクションでは、ALTER BUFFERPOOL コマンドの使用方法について詳しく説明します。

複数のバッファー・プール属性の変更: 1 つのバッファー・プール属性の変更が失敗しても、同じコマンドで要求された他の変更には影響を与えません。

仮想記憶域不足: バッファー・プールの拡張中に仮想記憶域不足が検出されると、DB2 はエラー・メッセージを出して、その処理を終了し、バッファー・プールは要求されたサイズより小さいままの状態です。

アクティブなバッファー・プールの縮小: ALTER BUFFERPOOL を使用してアクティブなバッファー・プールのサイズを縮小すると、DB2 ではアクティブなバッファーに「削除予定」(他のページ要求を満たすためにこれらのアクティブ・バッファーを再使用可能でないことを意味する) のマーク付けをすることでプールを縮小します。しかし、仮想記憶域は即時に解放されない場合もあります。システム管理者は、DISPLAY BUFFERPOOL コマンドを出すことによってバッファー・プールの状況を判別することができます。

アクティブ・バッファー・プールの削除: ALTER BUFFERPOOL を使用してアクティブ・バッファー・プールを (VPSIZE に 0 を指定して) 削除する場合、DB2 では、このバッファー・プールを明示的に削除できる状態にあることを示すメッセージを出します。DB2 がバッファー・プール削除要求を受け入れると、そのバッファー・プールは ″削除ペンディング中″ としてマークされます。このバッファー・プールへの現行アクセスはすべて静止状態となり、それ以降このバッファー・プールにアクセスしようとすると、エラー・メッセージが出されて失敗し、そしてこのバッファー・プールを参照するオープン状態のページ・セットすべてがクローズされます。

BSDS に保管された属性の変更: BSDS に保管されたバッファー・プール属性はオフライン状態では変更できません。

バッファー・プールを実記憶域に固定するための設定: PGFIX を YES に指定したALTER BUFFERPOOL コマンドを使用してバッファー・プールを実記憶域に固定する場合は、その変更はペンディング状態となり、そのバッファー・プールは次の割り振り時でのみ固定されます。

バッファー・プールを実記憶域に固定するには、ALTER BUFFERPOOL(bpname)

PGFIX(YES) コマンドを発行します。bpname に指定したそのバッファー・プールが現在割り振られていない場合、そのバッファー・プールは、割り振り時に実記憶域に固定されます。bpname に指定したそのバッファー・プールが現在割り振られている場合は、以下のいずれかの手順を実行してそのバッファー・プールを実記憶域に固定します。



|

|

|

|

|

|

v bpname に指定したバッファー・プールが、DB2 カタログおよびディレクトリーに使用されるバッファー・プール (BP0、BP8K0、BP16K0、または BP32K) でない場合:

1. VPSIZE オプションを 0 に設定した ALTER BUFFERPOOL コマンドを出してバッファー・プールを割り振り解除します。

-ALTER BUFFERPOOL(bpname) VPSIZE(0)

2. VPSIZE および PGFIX オプションを指定した ALTER BUFFERPOOL を出してバッファー・プール・サイズを変更し、次回の割り振り時に長期間ページ固定化を使用します。

-ALTER BUFFERPOOL(bpname) VPSIZE(vpsize) PGFIX(YES)

v bpname で指定したバッファー・プールが、DB2 カタログおよびディレクトリーで使用するいずれかのバッファー・プール (BP0、BP8K0、BP16K0、またはBP32K) である場合:

1. PGFIX オプション指定の ALTER BUFFERPOOL コマンドを出してバッファー・プールを変更し、長期間ページ固定化を使用します (この変更は、次回のバッファー・プール割り振り時までペンディングされます)。

-ALTER BUFFERPOOL(bpname) PGFIX(YES)

2. STOP DATABASE コマンドまたは STOP DB2 コマンドを出して、そのバッファー・プールを割り振り解除する

3. START DATABASE コマンドまたは START DB2 コマンドを出して、そのバッファー・プールを割り振り解除する (どちらのコマンドを使用するかは、バッファー・プールの割り振り解除に使用したコマンドで決まる)

VPPSEQT と VPXSEQT の関連付け: 表 7 は、2 つの並列順次しきい値 (並列順次のための VPPSEQT と並列順次しきい値の支援の VPXPSEQT) との関係を示しています。VPXPSEQT は VPPSEQT (これ自身が VPSEQT の一部) のパーセントを表しています。VPXPSEQT と VPPSEQT を乗算し、別の DB2 サブシステムの並列処理を援助するために使用できるバッファー・プールの合計量を求めます。さらに、VPPSEQT は、VPSIZE と VPSEQT の変更による影響を受けます。したがって、VPXPSEQT も、VPSIZE と VPSEQT の影響を受けます。各種しきい値と可能な構成との関係について詳しくは、「DB2 データ共用: 計画および管理」第 6 章を参照してください。

表 7. VPPSEQT と VPXPSEQT の関係

VPPSEQT の設定値および VPXPSEQT の設定値

シスプレックス照会並列処理を援助するために使用可能なバッファー・プールのパーセント

50 50 25

50 100 50

100 50 50

任意の値 0 0

0 任意の値 0

例例 1: 次のコマンドは、BP0 用のバッファー・プールを 2000 に設定します。

-ALTER BUFFERPOOL(BP0) VPSIZE(2000)



|

|

|

|

例 2: 次のコマンドは、BP0 用のバッファー・プールの順次スチールしきい値をバッファー・プール・サイズの 75 % に設定します。

-ALTER BUFFERPOOL(BP0) VPSEQT(75)

例 3: 次のコマンドは BP1 を削除します。このオプションを使用するときは、細心の注意が必要です。それは、アクティブ・バッファー・プールに対して 0 サイズを指定すると、DB2 が現行のすべてのデータベース・アクセスを静止状態にするからです。ページ・セットを開くための後続の要求はすべて失敗します。

-ALTER BUFFERPOOL(BP1) VPSIZE(0)



|

|

|

|

第 10 章 -ALTER GROUPBUFFERPOOL (DB2)

DB2 コマンド ALTER GROUPBUFFERPOOL は、グループ・バッファー・プールの属性を更新します。

省略形: -ALT GBPOOL


v 『環境』

v 『許可』





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

データ共用範囲: グループ




構文

�� ALTER GROUPBUFFERPOOL ( gbpname )structure-name GBPCACHE( YES )

NO

�

�AUTOREC( YES )

NORATIO(ratio) CLASST(integer)

�

�GBPOOLT(integer) GBPCHKPT(integer)

��

オプションの説明(gbpname)更新する DB2 グループ・バッファー・プールを指定します。v 4 KB グループ・バッファー・プールは、GBP0、GBP1、...、GBP49 と名前を指定します。

v 8 KB グループ・バッファー・プールは、GBP8K0、GBP8K1、...、GBP8K9

と名前を指定します。v 16 KB グループ・バッファー・プールは、GBP16K0、GBP16K1、...、

GBP16K9 と名前を指定します。v 32 KB グループ・バッファー・プールには、GBP32K、GBP32K1、...、

GBP32K9 と名前を指定します。

(structure-name)グループ・バッファー・プール用のカップリング・ファシリティー構造を指定します。カップリング・ファシリティー構造名は、groupname_gbpname の形式になっています。

groupname は DB2 データ共用グループ名であり、下線 (_) によってgroupname と gbpname が区切られています。

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

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

ページ・セットまたはグループ・バッファー・プールのレベルで指定された、すべての「データ・キャッシングなし」の属性が、キャッシングの指定より優先します。詳しくは、 39ページの表 8 を参照してください。

-ALTER GROUPBUFFERPOOL (DB2)


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

グループ・バッファー・プールの指定ページ・セットの指定優先される属性

GBPCACHE(NO)

GBPCACHE CHANGED

GBPCACHE ALL GBPCACHE(NO)

GBPCACHE(YES) GBPCACHE NONE GBPCACHE NONE

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

オプションは無視されます。

AUTORECある構造に障害が発生するかまたはグループ・バッファー・プールに対するグループの全メンバーの接続性が失われたときに、DB2 が自動リカバリーを実行するかどうかを指定します。

(YES)グループ・バッファー・プール RECOVER がペンディング (GRECP) 状況になっていて、論理ページ・リストにページが存在しているページ・セットとパーティションを DB2 が自動的にリカバリーできるようにします。

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

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

ratio には、1.0 ～ 255 まで (両数字を含む) の 10 進数を指定できます。なお、小数点第 2 位以下の桁はすべて無視されます。例えば、5.67 は 5.6 として処理されます。ratio が 25 を超えると、小数点以下の桁はすべて無視されます。例えば、25.98 は 25 として処理されます。デフォルトの ratio は 5 です。

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

CLASST (integer)クラス・キャストアウトが開始されるしきい値を変更します。integer は、データ項目数に対するパーセントで表現します。その範囲は 0 ～ 90 となっています。デフォルトは 5 パーセントです。

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


第 10 章 -ALTER GROUPBUFFERPOOL (DB2) 39

GBPOOLT (integer)グループ・バッファー・プールのデータをディスクにキャストアウトするしきい値を変更します。integer は、データ項目数に対するパーセントで表現し、その範囲は 0 ～ 90 となっています。デフォルトは 30 パーセントです。

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

GBPCHKPT (integer)あるグループ・バッファー・プールチェックポイントから後続のグループ・バッファー・プールのチェックポイントまでの時間間隔 (分単位) を変更します。integer の範囲は 1 ～ 999999 となります。GBPCHKPT オプションに明示的に値が指定されていなければ、デフォルト値は 4 分となります。

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

使用上の注意デフォルト: ALTER GROUPBUFFERPOOL コマンドを発行しても、明示的に指定されていないオプションは変更されません。つまり、そのオプションのデフォルト値は変更されないままです。表 9 は、グループ・バッファー・プールまたは構造に最初にこのコマンドを発行した時点におけるオプションのデフォルト値をリストしたものです。

表 9. ALTER GROUPBUFFERPOOL を最初に発行した時点でのデフォルト・オプション値

オプション値

GBPCACHE YES

RATIO 5

CLASST 5 (%)

GBPOOLT 30 (%)

GBPCHKPT 4 (分)

新しい値が有効になる時点: ALTER GROUPBUFFERPOOL コマンドを発行する場合、一部のオプション指定は、次回にグループ・バッファー・プールを割り振る時点で初めて有効になります。表 10 は、新規の値が有効になった時点の各オプションをリストしたもので、GBPCACHE(NO) として指定されたグループ・バッファー・プール・プールに適用可能な場合のオプションを示しています。

表 10. グループ・バッファー・プール属性の変更

キーワード新しい値が有効になる時GBPCACHE(NO) の場合、適用されるか

GBPCACHE 次の割り振り時適用外

AUTOREC 即時にいいえ

RATIO 次の割り振り時 2 いいえ3

CLASST 即時にいいえ3

GBPOOLT 即時にいいえ3



表 10. グループ・バッファー・プール属性の変更 (続き)

キーワード新しい値が有効になる時GBPCACHE(NO) の場合、適用されるか

GBPCHKPT 即時にいいえ3

注:

1. グループ・バッファー・プールが二重化されていない場合は、z/OS コマンドの SETXCF

START,REBUILD を使用して変更を有効にすることができます。グループ・バッファー・プールが二重になっており、GBPCACHE(NO) に変更したい場合は、まずシンプレックス・モードに戻って、作成し直します。GBPCACHE(NO) は二重グループ・バッファー・プールには許されません。

2. グループ・バッファー・プールが二重化されていない場合は、z/OS コマンドの SETXCF

START,REBUILD を使用して変更を有効にすることができます。グループ・バッファー・プールが二重になっている場合は、まずシンプレックス・モードに戻って、作成し直し、その後オプションとして二重モードに戻します。グループ・バッファー・プールが二重になっている場合、その二重になっているグループ・バッファー・プールの両方のインスタンスは、同じ RATIO 値を使用します。

3. GBPCACHE(NO) のグループ・バッファー・プールにこのオプションを指定すると、DB2

はメッセージ DSNB761 を出します。これらの設定は、GBPCACHE 属性が YES に変更された後でのみ有効になります。

例例 1: グループ・バッファー・プール 0 に対して、すべてのデータ・ページに対するディレクトリー項目の比率を、各データ・ページに付き 1 つのディレクトリー項目に変更します。RATIO の指定が有効になるのは、グループ・バッファー・プールの次回の割り振り時となります。

-DB1G ALTER GROUPBUFFERPOOL (GBP0) RATIO(1)

例 2: グループ・バッファー・プール 2 に対して、クラス・キャストアウトしきい値を 10 % に、またグループ・バッファー・プール・キャストアウトしきい値を50 % に変更します。その新しい値はすぐに有効になります。

-DB1G ALTER GROUPBUFFERPOOL (GBP2) CLASST(10) GBPOOLT(50)

例 3: DB2 グループ名を DSNCAT と想定します。グループ・バッファー・プール3 に対して、クラス・キャストアウトしきい値を 10 % に変更します。その新しい値はすぐに有効になります。グループ名は DSNCAT なので、そのカップリング・ファシリティー構造の名前は DSNCAT_GBP3 となります。また、ある構造に障害が発生した場合、AUTOREC(YES) オプションを指定すると、DB2 は GRECP 状況にあるページ・セットおよびパーティションまたは論理ページ・リストにページが存在するページ・セットおよびパーティションを自動的にリカバリーできるようにします。

-DB1G ALTER GROUPBUFFERPOOL (DSNCAT_GBP3) CLASST(10) AUTOREC(YES)

例 4: グループ・バッファー・プール 32K に対して、GBP チェックポイント頻度を 5 分に変更します。その新しい値はすぐに有効になります。この例では、AUTOREC(NO) が指定されているので、ある構造に障害が発生しても DB2 は自動リカバリーを開始しません。このオプションを選択する可能性があるのは、START


第 10 章 -ALTER GROUPBUFFERPOOL (DB2) 41

DATABASE コマンドを入力して指定したオプションを持つデータをリカバリーする前に、どのページ・セットまたはパーティションが GRECP 状況にあるか、またはどのページ・セットまたはパーティションが論理ページ・リスト上にページを保有しているかを判別したい場合です。

-DB1G ALTER GROUPBUFFERPOOL (GBP32K) GBPCHKPT(5) AUTOREC(NO)



第 11 章 -ALTER UTILITY (DB2)

DB2 コマンド ALTER UTILITY は、SHRLEVEL REFERENCE または CHANGE

を使用する REORG ユーティリティーの実行の特定のパラメーターの値を変更します。具体的には、このコマンドは DEADLINE、MAXRO、LONGLOG、およびDELAY の値を変更します。これらのパラメーターと REORG ユーティリティーの詳細については、「DB2 ユーティリティー・ガイドおよび解説書」を参照してください。

REORG は、REORG を実行している DB2 からだけ変更することができます。

省略形: -ALT UTIL


v 『環境』

v 『許可』





環境このコマンドは、z/OS コンソール、DSN セッション、DB2I パネル (DB2

COMMANDS)、 IMS または CICS 端末、または計測機能インターフェース (IFI)

を使用するプログラムから出すことができます。


許可このコマンドを実行するには、元になるユーティリティー・ジョブをサブミット時点の処理の 1 次または何らかの 2 次許可 ID を使用する必要があります。あるいは、以下のいずれかの権限を持った、処理の権限セットを使用する必要があります。v DBMAINT 権限v DBCTRL 権限v DBADM 権限v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限



DBMAINT、DBCTRL、または DBADM 権限が割り当てられているユーザーの場合は、ユーティリティー・ジョブがアクセスする各オブジェクトにユーザーが十分な権限を持っているときだけコマンドは有効になります。

構文

�� ALTER UTILITY (utility-id) REORGDEADLINE( NONE )

timestamp

�

�MAXRO( integer )

DEFERLONGLOG( CONTINUE )

TERMDRAIN

DELAY(integer)��

オプションの説明(utility-id)ユーティリティー・ジョブ・ステップの作成時に使用されたユーティリティーID または UID パラメーター。

このジョブは、SHRLEVEL CHANGE または SHRLEVEL REFERENCE を指定した REORG を実行する必要があります。

utility-id がデフォルトの DSNU CLIST によって作成された場合の形式は、tso-userid.control-file-name となります。各ユーティリティーに関連した制御ファイル名については、「DB2 ユーティリティー・ガイドおよび解説書」を参照してください。

DSNUTLIB を実行した EXEC ステートメントによりデフォルトで utility-id が作成された場合は、その形式は userid.jobname になります。

DEADLINE再編成の切り替えフェーズを開始する締切時刻を指定します。切り替えフェーズが締切時刻までに開始されないことを DB2 が知ると、 DB2 は再編成を終了します。デフォルトは、DEADLINE に最後に指定された値です。

事前切り替え処理が締切時刻後にも継続されることがあります。

(NONE)ログ処理の読み取り専用反復について締切時刻がないことを指定します。

(timestamp)切り替えフェーズに処理を開始させたい締切時刻を指定します。この締切時刻は、ALTER UTILITY の実行時刻より前でなければなりません。タイム・スタンプを指定する形式の詳細については、「DB2 SQL 解説書」のデータ・タイプに関する説明を参照してください。

MAXRO再編成時の最後のログ処理反復に関する最大許容時間を指定します。その反復時には、アプリケーションには読取専用アクセスが割り当てられます。

-ALTER UTILITY (DB2)


最後の反復の実際の実行時間は、MAXRO に指定した値を超えることがあります。

(integer)秒数を指定します。デフォルトは、MAXRO に最後に指定された値です。

(DEFER)ログ・フェーズを無期限に延期することを指定します。

LONGLOG次の反復で処理されるログ・レコード数が直前の反復で処理されたログ・レコード数を十分に下回っていない場合、(LONGLOG メッセージをコンソールに送信した後に) DB2 が実行するアクションを指定します。デフォルトは、LONGLOG に最後に指定された値です。

(CONTINUE)DB2 が再編成の実行を継続することを指定します。

(TERM)指定された時間後に DB2 が再編成を終了することを指定します。

(DRAIN)DB2 が遅延時間 (指定されている場合) 後に書き出しクレーム・クラスをドレーンすることを指定します。ログ処理の今後の反復に関するログ・レコード数、したがって予測時間は、0 になります。

DELAY (integer)REORG がコンソールに LONGLOG メッセージを送信してから REORG がLONGLOG パラメーターにより指定されるアクションを実行するまでの間隔の下限を指定します。

integer は遅延 (秒数) です。この値に負の値を指定することはできません。デフォルトは、DELAY に最後に指定された値です。

使用上の注意REORG ジョブは、REORG が実行されている DB2 サブシステムからのみ変更することができます。

例以下の例は、(ユーティリティーの ID REORGEMP の) ユーティリティー・ジョブ・ステップの REORG ユーティリティーの実行を変更します。

-ALTER UTILITY (REORGEMP) REORG MAXRO(240) LONGLOG(DRAIN)

上の例で各オプションが行っていることは、次のとおりです。

v MAXRO (240) は、ログ処理の最後の反復の最大許容時間を 240 秒 (4 分) に変更します。

v LONGLOG(DRAIN) は、DB2 が書き込みクレーム・クラスをドレーンすることを指定します (REORG 中のログの読み取りが、アプリケーションのログ書き込み速度に追いつかない場合)。


第 11 章 -ALTER UTILITY (DB2) 45

v DELAY が指定されていないため、この例では LONGLOG メッセージがコンソールに送られてから LONGLOG により指定されるアクションが実行されるまでの間の現行の遅延時間は変更されません。

v DEADLINE が指定されていないため、この例ではログ処理の最後の反復の締切時刻 (存在する場合) は変更されません。



第 12 章 -ARCHIVE LOG (DB2)

DB2 コマンド ARCHIVE LOG は、オプションを指定せずに入力すると以下の機能を実行します。v 現行のアクティブ・ログ・データ・セットを途中で終らせますv 非同期タスクを開始し、データ・セットをオフロードしますv まだアーカイブされていない、前のアクティブ・ログ・データ・セットをアーカイブします

v 制御をユーザーに戻します (即時に)

データ共用環境、ログを途中で終らせることとアーカイブは個々のメンバー、またはグループ内のすべてのメンバーに対して実行することが可能です。

オプション MODE(QUIESCE) を指定すると、ARCHIVE LOG コマンドはオフロード処理の前に、DB2 アクティブ・ログに対する DB2 ユーザー更新アクティビティーをすべて静止 (延期) しようと試みます。システム規模の一貫性ポイントに到達すると (すなわち。現在アクティブな更新ユーザーがすべてコミット・ポイントに到達したとき)、アクティブ・ログは即時に切り捨てられ、オフロード処理が開始されます。結果の一貫性ポイントは、オフロードされる前に、現行のアクティブ・ログに取り込まれます。なおデータ共用環境は、システム規模の一貫性ポイントは、グループ全体に対してのみ作成可能です。

ARCHIVE LOG コマンドの詳細については、「DB2 管理ガイド」第 4 部 (第 1

巻) を参照してください。

省略形: -ARC LOG


v 『環境』

v 48ページの『許可』






さらに、ARCHIVE LOG コマンドを z/OS サブシステム・インターフェース (SSI)

から発行して、自動スケジューリング・システムやその他のプログラムが監視プログラム呼び出し命令 (SVC) 34 経由でこのコマンドを呼び出せるようにすることも可能です。


データ共用範囲: グループまたはメンバー。MODE(QUIESCE) を指定したか否か、またはどの SCOPE オプションを選択したかにより異なります。

許可このコマンドを実行するには、次のいずれかの特権または権限を含む処理の特権セットを使用する必要があります。v ARCHIVE 特権v インストール SYSOPR 権限v SYSCTRL 権限v SYSADM 権限


構文

�� ARCHIVE LOGMODE(QUIESCE)

TIME(nnn) NOWAIT( )

YESMEMBER

SCOPE( GROUP )CANCEL OFFLOAD

��

オプションの説明MODE(QUIESCE)

DB2 サブシステムによるすべての新しい更新アクティビティーを指定された時間だけ停止させ、コミット後またはロールバック後にすべての既存のユーザーを一貫性ポイントに到達させようと試みます。一貫性ポイントに到達してそれが現行アクティブ・ログ・データ・セットに取り込まれると、現行アクティブ・ログ・データ・セットは途中で終了し、インベントリー内の別のログ・データ・セットが現行のものになります。その後、オフロード処理が一番古いアクティブ・ログ・データ・セットから開始され、途中まで書き込まれたアクティブ・ログ・データ・セットで終了します。

データ共用環境は、このオプションはメンバーのログをアーカイブする前に、データ共用グループのすべてのアクティブ・メンバーを静止させます。MODE(QUIESCE) は、それぞれの非アクティブ・メンバーがその更新活動を正常に静止して、非アクティブのサブシステムが正常に終了する前に未確定のリカバリー単位 (UR) をすべて解決していることも確認します。いずれかの DB2 サブシステムが、障害状態であったり、静止処理中に障害が生じたり、未解決のUR により停止した場合には、ARCHIVE LOG コマンドは失敗して、残っているアクティブ・メンバーは引き続き更新アクティビティーができるようになります。

-ARCHIVE LOG (DB2)


静止したすべてのメンバー (アクティブまたは非アクティブ) に未確定の UR

が存在していなければ、そのアーカイブ操作はグループ内のアクティブ・メンバーに対して続行されます。したがって、ユーザーはデータ共用グループのログを、すべてのメンバーを強制的にアクティブ状態にすることなく、正常にアーカイブすることができます。非アクティブ・メンバーの現行ログは、非アクティブ・メンバーが始動した後に途中で終了し、オフロードされます。

静止期間 (ユーザーが指定できる時間の長さのこと) 中に、システム全体に渡って一貫性を保証できるポイントに到達できなかった場合、ARCHIVE LOG コマンドの実行は失敗してエラー・メッセージが出されます。データ共用環境では、最大時間枠がグループ全体に適用され、いずれかの DB2 サブシステムが許容時間内に静止できなかった場合には、そのコマンドは失敗します。

コマンド ARCHIVE LOG MODE(QUIESCE) が発行された時点で DB2 データに対する更新アクティビティーがなければ、アクティブ・ログは即時にそこで最後にして、オフロードされます。

TIME(nnn)全システムの静止を試みるために DB2 サブシステムが使用できる最大時間長を、秒単位で指定します。

時間を指定していない場合、そのデフォルトは、インストール・パネル「DSNTIPA」のフィールド「QUIESCE PERIOD」に指定した時間の長さとなります。このフィールドの詳細については、「DB2 インストレーション・ガイド」第 2 部を参照してください。

nnn の範囲は 001 ～ 999 秒です。静止処理には適切な時間枠を割り振る必要があります。これが適切でないと、以下のことが起きる可能性があります。v 静止が全部完了する前に、静止処理が時間切れになる。v 不必要な DB2 ロック競合を課せられる可能性がある。v タイムアウトが生じる。

このオプションは、オプション MODE(QUIESCE) と一緒に使用される場合のみ有効です。

WAITDB2 サブシステムが静止処理の完了を待って呼び出したコンソールまたはプログラムに制御を戻すべきか、あるいは静止処理が始まったときに制御を戻すべきかを指定します。

このオプションは、オプション MODE(QUIESCE) と一緒に使用される場合のみ有効です。

(NO)静止処理の開始時に、制御を呼び出し側プログラムに戻さなければならないことを指定します。

WAIT(NO) を使用すると、静止処理はユーザーに対して非同期となります。つまり、ARCHIVE LOG コマンドが制御をユーザーに戻したら、ユーザーはさらに別の DB2 コマンドを発行することができます。

(YES)呼び出しコンソールまたはプログラムに制御を戻す前に、静止処理を完了しなければならないことを指定します。

-ARCHIVE LOG (DB2)

第 12 章 -ARCHIVE LOG (DB2) 49

WAIT(YES) を使用すると、静止処理はユーザーとの同期をとります。つまり、さらに別の DB2 コマンドを発行することは可能ですが、それらのコマンドに対しては、ARCHIVE LOG コマンドが完了するまでDB2 コマンド・プロセッサーによる処理は行われません。

SCOPEコマンドをデータ共用グループ全体に適用するのか、または単一のメンバーのみに適用するのかを指定します。SCOPE オプションは、データ共用環境のみ有効です。非データ共用環境、このオプションは無視されます。SCOPE はMODE(QUIESCE) が指定されていると指定できません。この 2 つのキーワードは、どちらか一方が指定されていると他方を指定することができません。

(MEMBER)コマンドを発行したメンバーに対してのみオフロード処理を開始します。ユーザー更新活動は延期されません。そのメンバーまたはそのグループ全体がすでにアーカイブされていると、このコマンドは失敗します。これがデフォルトとなっていますが、 MODE(QUIESCE) が指定されている場合は例外です。

(GROUP)DB2 グループの全メンバーに対するオフロード処理を開始します。ユーザー更新活動は延期されません。そのグループのいずれかのメンバー、またはそのグループ全体がすでにアーカイブされていると、このコマンドは失敗します。

CANCEL OFFLOAD現在実行中のオフロードをすべて取り消してから、オフロード処理を再び開始します。再開されたオフロード処理では、まだオフロードされていない一番古いアクティブ・ログ・データ・セットから処理が開始され、オフロードする必要のあるすべてのアクティブ・ログ・データ・セットを順次処理します。延期されているオフロード操作もすべて再開始されます。

使用上の注意リモート・サイト・リカバリー: ARCHIVE LOG コマンドは、リモート・サイト・リカバリーに備えて DB2 のバックアップを実行するときにきわめて有用です。例えば、このコマンドによって DB2 サブシステムはコミット・ポイント後にすべてのユーザーを静止させ、アクティブ・ログ (データ・セット) がアーカイブされる前に、その一貫性ポイントを現行アクティブ・ログに取り込むことができます。したがって、アーカイブ・ログが最新のイメージ・コピー (オフサイト・リカバリー中の) で使用されていれば、データ不整合の数が最小になります。バックアップとリカバリーの詳細については、「DB2 管理ガイド」第 4 部 (第 1 巻) を参照してください。

同時実行: ARCHIVE LOG コマンドは、別の ARCHIVE LOG コマンドが実行中には実行できません。コマンドを実行しようとするとエラー・メッセージ DSNJ318I

が出され、コマンドは失敗します。これは、データ共用およびデータ非共用のいずれの環境においても当てはまります。例えば、データ共用環境データ共用メンバー(あるいはそのメンバーが属しているグループ) がすでにアーカイブ中であると、このコマンドは失敗します。

-ARCHIVE LOG (DB2)


使用可能なアクティブ・ログ・スペース: ARCHIVE LOG は以下の理由により、現行アクティブ・ログが使用可能な最後のアクティブ・ログ・データ・セットであるときは使用できません。v 使用可能なアクティブ・ログ・スペースがすべて使用されてしまう可能性がある。

v DB2 サブシステムは、オフロードが完了するまで処理を停止する可能性がある。

STOP DB2 の処理中に ARCHIVE LOG を実行する: STOP DB2 MODE(QUIESCE)

の処理中に、オプション MODE(QUIESCE) を指定しない ARCHIVE LOG を使用することが可能です。ただし、STOP DB2 MODE(FORCE) の処理中に ARCHIVE

LOG コマンドを実行しようとすると、エラー・メッセージ DSNJ315I が出されてARCHIVE LOG コマンドは処理されません。

オプション MODE(QUIESCE) を指定した ARCHIVE LOG は、STOP DB2

MODE(FORCE) の処理中、または STOP DB2 MODE(QUIESCE) の処理中に使用することはできません。この状況下で ARCHIVE LOG コマンドを実行しようとすると、エラー・メッセージ DSNJ315I または DSNJ316I が出されます。

システムが完全に静止しなかった場合は (静止できなかったユーザー数によって判別される)、エラー・メッセージ DSNJ317I が出されて ARCHIVE LOG コマンドの処理が終了します。現行アクティブ・ログ・データ・セットは途中で終了せずに、次に使用可能なアクティブ・ログ・データ・セットに切り替えられ、アーカイブ・ログは作成されません。

ログのオフロード取り消し: 割り振りやテープ装置のマウントにおける問題など、オフロード処理のときに問題が生じることがありますが、そのような場合にはアクティブ・ログのオフロードを延期することができます。ARCHIVE LOG CANCEL

OFFLOAD を発行することにより、オフロード処理に割り込みを行い、オフロードを再開始させます。このコマンドによってオフロードのタスクの異常終了が生じて、結果としてダンプが行われます。なお、ARCHIVE LOG CANCEL OFFLOAD

を使用するのは、オフロードのタスクがもはや機能していない場合、あるいは以前に失敗したオフロードを再び開始したい場合だけにしてください。

DB2 リソースの要求: ピーク・アクティビティー時または時間的に制限があるときに MODE(QUIESCE) オプションを使用すると、DB2 リソースの全ユーザーに対しDB2 の可用性に重大な影響があります。

DISPLAY THREAD との対話: コマンド DISPLAY THREAD がメッセージDSNV400I を出すことにより、ARCHIVE LOG MODE(QUIESCE) コマンドがアクティブであることを示します。

データ共用グループのメンバーの静止: データ共用グループの単一のメンバーを静止させることは不可能です。データ共用グループに MODE(QUIESCE) を指定すると、そのデータ共用グループ全体は静止します。

ロギングが延期されているときに ARCHIVE LOG を実行する: SET LOG

SUSPEND によりロギングが延期されている間は、CANCEL OFFLOAD が指定されている場合以外、ARCHIVE LOG を使用しないでください。ロギングが延期されている場合は、SET LOG RESUME を発行してロギングを再開してから ARCHIVE

LOG を発行します。

-ARCHIVE LOG (DB2)


例例 1: 現行のアクティブ・ログ・データ・セットを途中で終了し、その途中で終了したデータ・セットをオフロードするために非同期ジョブを開始します。静止処理は発生しません。

-ARCHIVE LOG

例 2: 静止期間を開始します。この期間内にすべての DB2 更新アクティビティーが停止した場合、現行のアクティブ・ログ・データ・セットを途中で終了させ、次に使用可能なアクティブ・ログ・データ・セットに切り替えます。そして、インストール・パネル DSNTIPA のフィールド QUIESCE PERIOD にある値によって静止期間の長さを決定します。MODE(QUIESCE) 処理は非同期です。

DB2 サブシステムは静止期間が終わる前にすべての更新アクティビティーを正常にブロックできると、次の処理ステップへ進みます。静止時間枠が足りないためにDB2 サブシステムを正常に静止できないと、アクティブ・ログ・データ・セットは途中で終了せず、アーカイブは行われません。

-ARCHIVE LOG MODE(QUIESCE)

例 3: 静止期間を開始します。この期間内にすべての DB2 更新アクティビティーが停止した場合、現行のアクティブ・ログ・データ・セットを途中で終了させ、次に使用可能なアクティブ・ログ・データ・セットに切り替えます。静止処理の最大時間は 7 分 (420 秒) で、処理はその 7 分間にわたって同期です。

DB2 サブシステムは静止期間が終わる前にすべての更新アクティビティーを正常にブロックできると、次の処理ステップへ進みます。静止時間枠が足りないためにDB2 サブシステムを正常に静止できないと、アクティブ・ログ・データ・セットは途中で終了せず、アーカイブは行われません。

-ARCHIVE LOG MODE(QUIESCE) WAIT(YES) TIME(420)

例 4: データ共用環境、データ共用グループの全メンバーに対して静止期間を開始します。この期間内にすべての DB2 更新アクティビティーが停止した場合、現行のアクティブ・ログ・データ・セットを途中で終了させ、次に使用可能なアクティブ・ログ・データ・セットに切り替えます。静止時間枠として 10 分 (600 秒) を指定して、メンバー DB1G のインストール・パネル DSNTIPA のフィールドQUIESCE PERIOD にある値をオーバーライドします。更新アクティビティーがその 10 分の静止期間に静止しなかった場合、コマンドは失敗して、新しい更新アクティビティーが続行します。

-DB1G ARCHIVE LOG MODE(QUIESCE) TIME(600)

例 5: データ共用環境、グループ・メンバー DB2G のアクティブ・ログ・データ・セットを途中で終らせ、途中で終了したデータ・セットをオフロードするために非同期ジョブを開始します。ただし、静止処理は行いません。この例では、SCOPE(MEMBER) がデフォルトとして使用されます。

-DB2G ARCHIVE LOG

例 6: データ共用環境、データ共用グループの全メンバーのデータ・セットを途中で終らせ、その途中で終ったデータ・セットをオフロードするために非同期ジョブを開始します。ただし、静止処理は行いません。

-ARCHIVE LOG (DB2)


-DB2G ARCHIVE LOG SCOPE(GROUP)

-ARCHIVE LOG (DB2)


-ARCHIVE LOG (DB2)


第 13 章 BIND PACKAGE (DSN)

DSN サブコマンド BIND PACKAGE は、アプリケーション・パッケージを作成するときに使用します。DB2 の場合、パッケージの記述はカタログ表内に記録され、作成されたパッケージはディレクトリー内に保管されます。BIND PACKAGE の使用について詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。


v 『環境』

v 『許可』




環境BIND PACKAGE は DB2I から、またはフォアグラウンドとバックグラウンドのいずれかで稼働する TSO 下の DSN セッションから使用することができます。


許可パッケージ所有者には、BIND PACKAGE の対象となるパッケージに組み込まれたすべてのステートメントを実行するための許可が必要です。それがないと、パッケージの作成時にエラー・メッセージが出されます。(SYSADM 権限にはこの許可が含まれます。) VALIDATE(BIND) の場合、DB2 は許可をバインド時に検査します。VALIDATE(RUN) の場合、DB2 は最初は許可をバインド時に検査しますが、検査が失敗した場合 DB2 は実行時に許可を再検査します。

新しいパッケージ、または既存のパッケージの新しいバージョンを追加するのに必要な許可は、インストール・パネル DSNTIPP のフィールド BIND NEW

PACKAGE の値によって異なります。デフォルト値は BINDADD です。

56ページの表 11 には、BIND PACKAGE を実行するのに必要な許可がまとめられています。必要とされる許可は指定したバインド・オプションにより、また ADD

オプションの場合にはフィールド BIND NEW PACKAGE の値により異なります。


表 11. BIND PACKAGE オプションに必要な特権の要約

バインド・オプションインストール・パネル・フィールドBIND NEW PACKAGE

BIND PACKAGE を実行するのに必要な許可

ADD、デフォルトの所有者または 1

次許可 ID を使用BINDADD 新しいパッケージ、または既存パッケ

ージの新しいバージョンをコレクションに追加するには、1 次許可 ID (デフォルトの所有者) に以下のいずれか1 つが必要です。

v BINDADD システム特権、および該当のコレクションかすべてのコレクションに対する CREATE IN 特権と PACKADM 権限のいずれか一方

v SYSADM または SYSCTRL 権限

BIND 新しいパッケージ、または既存パッケージの新しいバージョンをコレクションに追加するには、1 次許可 ID (デフォルトの所有者) に以下のいずれか1 つが必要です。



v 該当するコレクション、またはすべてのコレクションに対するPACKADM 権限

v BIND パッケージ特権 (既存パッケージの新しいバージョンの追加のみが可能)

BIND PACKAGE (DSN)


表 11. BIND PACKAGE オプションに必要な特権の要約 (続き)



ADD、1 次許可 ID 以外の OWNER

を指定 (1)

BINDADD バインダーに SYSADM またはSYSCTRL 権限がない場合は、新しいパッケージ、または既存のパッケージの新しいバージョンをコレクションに追加するために、OWNER の許可 ID

に以下のいずれか 1 つが必要です。



BIND バインダーに SYSADM またはSYSCTRL 権限がない場合は、新しいパッケージ、または既存のパッケージの新しいバージョンをコレクションに追加するために、OWNER の許可 ID

に以下のいずれか 1 つが必要です。



v 該当するコレクション、またはすべてのコレクションに対するPACKADM 権限

v BIND パッケージ特権 (既存パッケージの新しいバージョンの追加のみが可能)

REPLACE、デフォルトの所有者または 1 次許可 ID を使用

BINDADD または BIND 1 次許可 ID には以下のいずれか 1

つが必要です。v パッケージの所有権v パッケージに対する BIND 特権v 該当するコレクション、またはすべてのコレクションに対するPACKADM 権限


REPLACE、1 次許可 ID 以外のOWNER を指定 (1)

BINDADD または BIND バインダーに SYSADM またはSYSCTRL 権限がない場合は、OWNER の許可 ID に以下のいずれか1 つが必要です。v パッケージに対する BIND 特権v 該当するコレクション、またはすべてのコレクションに対するPACKADM 権限


BIND PACKAGE (DSN)

第 13 章 BIND PACKAGE (DSN) 57

表 11. BIND PACKAGE オプションに必要な特権の要約 (続き)



COPY BINDADD または BIND バインダーまたは OWNER の 1 次または 2 次許可 ID には、コピーされるパッケージについて以下のいずれか1 つが必要です。v パッケージの所有権v パッケージに対する COPY 特権v パッケージの所有者からの

BINDAGENT 特権v 該当するコレクション、またはすべてのコレクションに対するPACKADM 権限


注:

1. 処理のいずれかの許可 ID に SYSADM 権限または SYSCTRL 権限があれば、 OWNER authorization-id には任意の値を指定できます。許可 ID のいずれかに所有者から認可された BINDAGENT 特権がある場合、authorization-id

は認可者を OWNER として指定することができます。そうでない場合、OWNER authorization-id はバインダーの 1

次または 2 次許可 ID の 1 つでなければなりません。

BIND PACKAGE を実行するために必要な許可については、「DB2 管理ガイド」第5 部 (第 2 巻) を参照してください。

BIND PACKAGE (DSN)


構文

�� BIND PACKAGE ( .collection-id )location-name OWNER(authorization-id)

�

� enable-blockQUALIFIER(qualifier-name)

�

� MEMBER(dbrm-member-name)LIBRARY(dbrm-pds-name)

COPY(collection-id.package-id)COPYVER(version-id) COMPOSITE

OPTIONS( COMMAND )

�

�DEFER(PREPARE)NODEFER(PREPARE)

ACTION (REPLACE)REPLVER(version-id)

(ADD)

�

�YES

CURRENTDATA( NO )DBPROTOCOL( DRDA )

PRIVATE1

DEGREE( ANY )

�

�DYNAMICRULES( RUN )

BINDDEFINEBINDDEFINERUNINVOKEBINDINVOKERUN

ENCODING( ASCII )EBCDICUNICODEccsid

NOEXPLAIN( YES )

�

�I

FLAG( W )EC

IMMEDWRITE( NO )YES

ISOLATION( RR )RSCSURNC

�

�NO

KEEPDYNAMIC( YES )(1)

NONE(2)

REOPT( ALWAYS )ONCE

OPTHINT( ’hint-id’ )�

�

�

,

PATH( schema-name )USER

RELEASE( COMMIT )DEALLOCATE

NOPACKAGESQLERROR( CONTINUE )

�

�RUN

VALIDATE( BIND )

��

注:

1 NOREOPT(VARS) は、REOPT(NONE) の同義語として指定できます。

2 REOPT(VARS) は、REOPT(ALWAYS) の同義語として指定できます。

BIND PACKAGE (DSN)


enable-block:

��

� �

�

�

�

�

�

ENABLE(*),

ENABLE ( BATCH )DISABLE DLIBATCH ,

DB2CALLCICS DLIBATCH( connection-name )IMS ,IMSBMPIMSMPP CICS( applid )REMOTE ,RRSAF

IMSBMP( imsid ),

IMSMPP( imsid ),

REMOTE( location-name )<luname>

��

オプションの説明構文図に示されているオプションの説明は、 69ページの『第 15 章 BIND およびREBIND オプション』に記載されています。

例例 1: ローカル・ロケーション USIBMSTODB22 にあるパッケージTEST.DSN8BC81 のバージョン APRIL_VERSION を、このパッケージの別のバージョンに置き換えます。新しいバージョン (または、同じバージョンである場合もある) は DBRM DSN8BC81 にあります。DBRM にバージョン ID が含まれていないと、そのパッケージのバージョン ID はデフォルトである空ストリングとなります。このパッケージは TSO BATCH 環境からのみ実行されます。また、接続 ID

が CON1 であれば CICS 環境から実行されます。修飾されていないすべての表、ビュー、別名、および索引名は、PRODUCTN という名前によって修飾されます。

BIND PACKAGE (USIBMSTODB22.TEST) -MEMBER (DSN8BC81) -ACTION (REPLACE) REPLVER (APRIL_VERSION) -QUALIFIER (PRODUCTN) -ENABLE (BATCH, CICS) CICS (CON1)

例 2: UR 分離機能によってロックが獲得されることはほとんどありません。この分離機能は高速で、競合はほとんど生じませんが、コミットされていないデータを読み取ります。次の例のようにアプリケーションやエンド・ユーザーが論理的な不整合データを受け入れることができることが確実でないのであれば、ISOLATION(UR)

を使用しないでください。

ある工場監督者が、SPUFI を使用して SQL ステートメントを定期的に実行することによって、組み立て工程にある部品の状況を検査し、その検査結果で表を更新しているとします。この工場監督者は部品の状況を正確に知る必要はありません。多少の誤差限界は受け入れられます。

BIND PACKAGE (DSN)


工場監督者は部品の状況を ASSEMBLY-STATUS という生産表から照会し、REPORTS という非生産表でその更新を行います。そして、SPUFI オプションAUTOCOMMIT NO を使用することで、別の作業をしている間もデータをそのまま画面に表示することにしています。

ISOLATION(UR) でバインドされた SPUFI のバージョンをこの工場監督者が実行する場合、部品の状況に対する照会は UR 分離レベルを使用することでロックを獲得することなく実行され、また更新は CS 分離レベルを使用して実行されることになります。そのため、照会が意図せずに生産表でロックを保持することで生産ジョブに干渉するということなく、工場監督者は自分の目的を果たすのに十分なデータを得ることになります。

SPUFI アプリケーションは以下のようにバインドされます。

BIND PACKAGE(DSNESPUR) -COPY(DSNESPCS.DSNESM68) -ACTION(ADD) -ISOLATION(UR)

BIND PACKAGE (DSN)


BIND PACKAGE (DSN)


第 14 章 BIND PLAN (DSN)

DSN サブコマンド BIND PLAN は、アプリケーション・プランを作成するときに使用します。DB2 プログラムはすべて、DB2 リソースを割り振り、実行時に出される SQL 要求をサポートするためにアプリケーション・プランを必要とします。BIND PLAN の使用について詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。


v 『環境』

v 『許可』




環境BIND PLAN は DB2I を介して、またはフォアグラウンドとバックグラウンドのいずれかで稼働する TSO 下の DSN セッションから使用することができます。


許可BIND PLAN がエラー・メッセージを出さずにプランを作成するには、プランの所有者がそのプランに組み込まれているすべての SQL ステートメントを実行する許可を有していることが必要です。そのプランのパッケージ・リストに含まれているパッケージにバインドされた DBRM に含まれるステートメントは除外されます。SYSADM 権限にはこの許可が含まれます。VALIDATE(BIND) の場合、DB2 は許可をバインド時に検査します。 VALIDATE(RUN) の場合、DB2 は最初は許可をバインド時に検査しますが、その検査が失敗した場合 DB2 は実行時に許可を再検査します。

表 12 では、BIND PLAN を実行するのに必要な許可を、指定したオプションに応じて説明しています。

表 12. BIND PLAN オプションに必要な特権の要約

オプション BIND PLAN を実行するのに必要な許可

ADD、デフォルトの所有者または 1

次許可 ID を使用

1 次許可 ID (デフォルトの所有者) には、以下のいずれか 1 つが必要です。v BINDADD 特権v SYSADM または SYSCTRL 権限

ADD、1 次許可 ID

以外の OWNER を指定

バインダーに SYSADM または SYSCTRL 権限がない場合は、新しいOWNER の許可 ID に以下のいずれか 1 つが必要です。v BINDADD 特権v SYSADM または SYSCTRL 権限


表 12. BIND PLAN オプションに必要な特権の要約 (続き)

オプション BIND PLAN を実行するのに必要な許可

REPLACE、デフォルトの所有者または1 次許可 ID を使用

処理の 1 次許可 ID には以下のいずれか 1 つが必要です。v プランの所有権v プランに対する BIND 特権v SYSADM または SYSCTRL 権限

REPLACE、 1 次許可 ID 以外のOWNER を指定

バインダーに SYSADM または SYSCTRL 権限がない場合は、OWNER

の許可 ID に以下のいずれか 1 つが必要です。v プランの所有権v プランに対する BIND 特権v SYSADM または SYSCTRL 権限

PKLIST、個々のパッケージを指定

処理の許可 ID には、以下のいずれか 1 つが含まれている必要があります。v PKLIST に指定された各パッケージの EXECUTE 権限v パッケージを含んだ特定のコレクションに対する、またはすべてのコレクションに対する PACKADM 権限

v SYSADM 権限

PKLIST、コレクション内のすべてのパッケージを示す (*)

を指定

処理の許可 ID には、以下のいずれか 1 つが含まれている必要があります。v collection-id.* に対する EXECUTE 権限v パッケージを含んだ特定のコレクションに対する、またはすべてのコレクションに対する PACKADM 権限

v SYSADM 権限

ADD および REPLACE の OWNER の指定: プロセスのいずれかの許可 ID にSYSADM 権限または SYSCTRL 権限があれば、OWNER authorization-id は任意の値で構いません。いずれかの許可 ID にその所有者から付与された BINDAGENT

特権がある場合、authorization-id は付与者を OWNER として指定することができます。そうでない場合、 OWNER authorization-id はバインダーの 1 次または 2 次許可 ID のいずれか 1 つでなければなりません。

BIND PLAN を実行するために必要な許可については、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。

BIND PLAN (DSN)


構文

�� BINDPLAN(plan-name) OWNER(authorization-id) QUALIFIER(qualifier-name)

�

� enable-block member-blockNODEFER(PREPARE)

DEFER(PREPARE) USEACQUIRE( ALLOCATE )

�

�(REPLACE)

RETAINACTION (ADD)

CACHESIZE(decimal-value) YESCURRENTDATA( NO )

�

�CURRENTSERVER(location-name) DBPROTOCOL( DRDA )

PRIVATE1

DEGREE( ANY )

�

�EXPLICIT

DISCONNECT( AUTOMATIC )CONDITIONAL

RUNDYNAMICRULES( BIND )


�

�NO

EXPLAIN( YES )I

FLAG( W )EC

IMMEDWRITE( NO )YES

ISOLATION( RR )RSCSUR

�

�NO

KEEPDYNAMIC( YES )(1)

NONE(2)

REOPT( ALWAYS )ONCE

OPTHINT( ’hint-id’ )�

�

�

,


COMMITRELEASE( DEALLOCATE )

DB2SQLRULES( STD )

�

�RUN

VALIDATE( BIND )

��

注:



BIND PLAN (DSN)

第 14 章 BIND PLAN (DSN) 65

enable-block:

��

� �

�

�

�

�

ENABLE(*), ,


DB2CALLCICS DLIBATCH( connection-name )IMS ,IMSBMPIMSMPP CICS( applid )RRSAF ,

IMSBMP( imsid ),

IMSMPP( imsid )

��

member-block:

��

�

�

,

MEMBER( dbrm-member-name ),

LIBRARY( dbrm-pds-name ),

PKLIST( collection-id. package-id )location-name. *. **.

��

オプションの説明構文図に示されているオプションの説明は、 69ページの『第 15 章 BIND およびREBIND オプション』に記載されています。

例例 1: このサブコマンドは、IMSONLY という新しいプランを作成します。このプランの SQL ステートメントは DBRM メンバー DSN8BC81 にあります。カーソル固定 (CS) の ISOLATION レベルは、プランの実行時に最大の並行性を提供します。また、このレベルではデータベース値の保護も行われますが、それはプログラムがそれらの値を使用している間だけです。プランを所有するのは DEPTM92 ですが、DBRM で参照される修飾されていない表、ビュー、索引、および別名の修飾はPRODUCTN が行います。

キャッシュ・サイズの 0 は、ユーザーがそのプランを複数回実行することがないことを示します。プランの実行を許可されているユーザーの名前のキャッシングを行うことは、プランが EDM プールにある間に同一のユーザーがそれを複数回実行す

BIND PLAN (DSN)


る場合にのみ役立ちます。これは今考えているプランには当てはまらないので、プランが使用しないスペースを EDM プールでキャッシュ用に予約しておく必要はありません。

オプション ENABLE(IMS) は IMS 環境 (DLI バッチ、BMP および MPP) からのみプランを実行します。別の環境、例えば TSO バッチからプランを実行しようとしてもプランの割り振りは行われません。

BIND PLAN(IMSONLY) -MEMBER(DSN8BC81) -ACTION(ADD) -ISOLATION(CS) -OWNER(DEPTM92) -QUALIFIER(PRODUCTN) -CACHESIZE -ENABLE(IMS)

例 2: 例 1 のプラン IMSONLY の DBRM に、組み込みと動的の両方の SQL ステートメントが含まれており、他のユーザーがそのプランを実行できるようにしたい場合、プラン IMSONLY に対する EXECUTE 特権をそれらのユーザーの許可 ID

に授与する必要があります。ただし、プランに対する EXECUTE 特権は DBRM の組み込み SQL ステートメントを実行するには十分の権限ですが、動的 SQL ステートメントを実行するには不十分です。そのため、さらに以下のいずれかを行うことが必要です。

v SQL GRANT ステートメントを使用して、動的 SQL ステートメントで参照しているオブジェクト (表、ビュー、別名、および索引) に対する必要な特権を、そのユーザーの許可 ID に授与する。

v プラン IMSONLY に対し、オプション DYNAMICRULES(BIND) を指定したBIND を以下のように実行する。

BIND PLAN(IMSONLY) -MEMBER(DSN8BC81) -ACTION(ADD) -ISOLATION(CS) -OWNER(DEPTM92) -QUALIFIER(PRODUCTN) -CACHESIZE(0) -ENABLE(IMS) -DYNAMICRULES(BIND)

プランに対する EXECUTE 特権だけを有する他のユーザーが、組み込みと動的の両方の SQL ステートメントを実行できるようにするには、そのプランをオプションDYNAMICRULES(BIND) でバインドする必要があります。DYNAMICRULES(BIND)

がプラン IMSONLY に対して有効になると以下のようになります。

v 単一の許可 ID (ここでは DEPTM92 の許可 ID) が、DBRM 内の組み込みおよび動的 SQL ステートメント両方の許可検査に使用される。

v DBRM 内の組み込みおよび動的 SQL ステートメント両方が参照する、未修飾のオブジェクト名の暗黙の修飾子が PRODUCTN になる。

例 3: このサブコマンドは、CICSONLY という新しいプランを作成します。プランは ISOLATION レベルのカーソル固定 (CS) を指定します。プランを所有するのはDEPTM12 ですが、DBRM で参照される修飾されていない表、ビュー、索引、および別名は TESTSYS で修飾されます。キャッシュ・サイズの 0 は、ユーザーがそのプランを複数回実行することがないことを示します。

BIND PLAN (DSN)

第 14 章 BIND PLAN (DSN) 67

オプション ENABLE(CICS) CICS(CON1) は、このプランを CICS VTAM® ノードCON1 からのみ実行し、これは CICS SIT テーブルの APPLID パラメーターで指定します。別の環境または別の CICS VTAM ノードからプランを実行しようとすれば、その実行は失敗します。

BIND PLAN(CICSONLY) -MEMBER(DSN8BC81) -ACTION(ADD) -ISOLATION(CS) -OWNER(DEPTM12) -QUALIFIER(TESTSYS) -CACHESIZE(0) -ENABLE(CICS) CICS(CON1)

BIND PLAN (DSN)


第 15 章 BIND および REBIND オプション

この章では、プランとパッケージのバインドまたは再バインドに使用できるオプションについて説明します。一部のオプションは、バインドと再バインドの両方で、またプランとパッケージの両方で共通のものです。

デフォルト: オプションのデフォルトとは、オプション全体を省略した場合に使用される値のことです。

BIND PACKAGE におけるプラン値のデフォルトとは、実行時にパッケージが追加されるプランの、バインドまたは再バインドの際に判別される値と、そのデフォルトが同じであることを意味します。

REBIND PLAN または REBIND PACKAGE における既存値のデフォルトとは、そのデフォルトが再バインド中のプランまたはパッケージの以前のバインディングまたは再バインドの際に判別された値であることを意味します。

他のすべての場合では、オプションの説明は特定のデフォルトについての記述となっており、DB2 がバインド時に割り当てるものです。特定のデフォルト値が存在する場合には、その値に下線が付けられています。

カタログ・レコード: DB2 カタログには、プランとパッケージについての情報が、主に表 SYSIBM.SYSPLAN および SYSIBM.SYSPACKAGE に記録されています。オプションがどこに情報を記録するかについての記述では、それらの表名の固定修飾子である SYSIBM は省かれています。

ACQUIRE (USE)

(ALLOCATE)

指定先: BIND と REBIND PLAN

MEMBER リストに指定された DBRM のリソースを、アプリケーションが最初にそれらにアクセスする時点、あるいはプランが割り振られた時点のいずれで獲得するかどうかを判別します。そのプランに関連したローカルまたはリモートのパッケージは、アプリケーションが最初にそれらにアクセスする時点でリソースを獲得します。

(USE)表スペース・ロックを獲得するのは、プランにバインドされたアプリケーション・プログラムがそれらを最初に使用するときに限られます。

(ALLOCATE)プランの割り振り時に、すべての表スペース・ロックを獲得します。この値は常時 ACQUIRE(USE) を使用する動的 SQL ステートメントには影響を与えません。

ACQUIRE(ALLOCATE) を使用する場合は、RELEASE(DEALLOCATE) も使用しなければなりません。ACQUIRE(ALLOCATE) を用いると追加項目がプランに常駐するためプラン・サイズが大きくなる可能性があります。

デフォルト:


処理デフォルト値

BIND PLAN USE

BIND PACKAGE 該当せず

REBIND PLAN 既存値

REBIND PACKAGE 該当せず

パッケージには ACQUIRE オプションはありません。パッケージは、あたかもACQUIRE(USE) が指定されているかのように、最初にリソースを使用する時にそのリソースを獲得します。「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。

カタログ・レコード: 表 SYSPLAN の列 ACQUIRE。

詳しい情報については、以下のそれぞれを参照してください。

v このオプションがロッキングと並行性にどのような影響を与えるかについては、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部または「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 4 部を参照してください。

v このオプションが選択パーティション・ロッキングのパフォーマンスをどのように向上させるかについては、「DB2 アプリケーション・プログラミングおよびSQL ガイド」第 5 部または「DB2 アプリケーション・プログラミングおよびSQL ガイド」第 4 部を参照してください。

v プランのサイズ見積もりについては、「DB2 管理ガイド」第 2 部を参照してください。

ACTION (REPLACE)

(REPLACE) RPLVER (BIND PACKAGE のみ)

(REPLACE) RETAIN (BIND PLAN のみ)

(ADD)

指定先: BIND PLAN とPACKAGE

オブジェクト (プランまたはパッケージ) を、同じ名前をもつ既存のオブジェクトと置き換えるか、それとも新しいものにするかを判別します。

(REPLACE)そのオブジェクトを同じ ID をもつ既存のものと置き換え、新しい項目をカタログ表 SYSPLAN または SYSPACKAGE にある古いものと置き換えます。指定された ID をもつオブジェクトがまだ存在していなかった場合には、新しいオブジェクトと新しい項目がバインド処理によって作成されます。

OWNER オプションで明示的にまたは暗黙に指定された許可 ID が、新しいオブジェクトの所有者になります。この許可 ID が前の所有者ではない場合は、前の所有者により認可された、該当のオブジェクトに対するすべての特権が新しい所有者を認可者として指名するよう変更されます。

バインドが失敗すると、古いオブジェクトとその項目はそのまま変わりません。

BIND PACKAGE の場合: REPLACE は、オプション ENABLE またはDISABLE のいずれかでバインドされたリモート・パッケージには使用できません。使用しようとすると、バインドが失敗します。

BIND および REBIND オプション


REPLVER(version-id) (BIND PACKAGE の場合のみ)version-id で示される、特定のバージョンのパッケージを置き換えます。指定された version-id のパッケージが存在しないと、バインドは失敗します。

version-id のデフォルトとなるのは、BIND に MEMBER オプションを使用している場合には DBRM からの、また COPY オプションを使用している場合には COPYVER オプションからのものです。

RETAIN (BIND PLAN の場合のみ)プランを置き換える際に EXECUTE 特権を保存します。プランの所有権が変更されると、新しい所有者は BIND 特権と EXECUTE 特権を以前の所有者に認可します。

RETAIN はデフォルトではありません。RETAIN を指定しないと、プラン所有者以外の全利用者が EXECUTE 特権を失うことになります (BIND 特権は失われません)。プランの所有権が変更されると、新しい所有者はBIND 特権を以前の所有者に認可します。

(ADD)新しいオブジェクトを追加しますが、既存のオブジェクトは置き換えません。そのオブジェクト名がカタログ内にすでに存在していると、バインドは失敗します。何かの理由でバインドが失敗した場合、バインド処理によって新しいパッケージまたはプランは作成されず、さらにカタログ内にも項目はできません。

パッケージ・バージョンの置き換え (REPLVER): このセクションでは、4 つの状態における ACTION(REPLACE) REPLVER の影響について説明します。ここでは、DBRM1 はメンバー名を表し、A と B はパッケージの 2 つのバージョンを表しています。そして、次のコマンドでバージョン A をバインドするとします。

BIND PACKAGE(COLL1) MEMBER(DBRM1) ACTION(REPLACE) REPLVER(B)

v DBRM1、バージョン A、バージョン B のいずれも DB2 カタログに存在していないと、バージョン B がカタログ内にないためにコマンドは失敗します。新しいパッケージは追加されません。

v DBRM1 とバージョン B は DB2 カタログに存在しているが、バージョン A は存在していない場合、バージョン A がバージョン B を置き換えます。その結果、バージョン A はカタログ内に存在し、バージョン B はカタログ内に存在しなくなります。

v DBRM1 とバージョン A はカタログに存在しているが、バージョン B は存在していない場合、コマンドはバージョン B がカタログ内にないために失敗します。バージョン A はそのまま存在しています。

v カタログ内に DBRM1 と A、B 両方のバージョンが存在していると、コマンドはバージョン A がすでに存在しているために失敗します。

デフォルト:


BIND PLAN REPLACE

BIND PACKAGE REPLACE

REBIND PLAN 該当せず



第 15 章 BIND および REBIND オプション 71

カタログ・レコード: 表 SYSPLAN または SYSPACKAGE。

CACHESIZE (フィールド PLAN AUTH CACHE の値)

(decimal-value)


プランの EDM プールに獲得された、許可キャッシュのサイズ (バイト単位) を判別します。実行時には、実行を許可されたユーザー ID が許可キャッシュに格納されます。キャッシュを調べれば、プランを実行するための許可の検査を行うためにカタログを検索しなくて済みます。

decimal-value

キャッシュのサイズは、0 ～ 4096 の範囲で指定できます。256 の倍数でない非ゼロ値は、次に大きな 256 の倍数に切り上げられます。CACHESIZE(0) を指定すると、プランの実行時にキャッシュが作成されません。

デフォルト:


BIND PLAN インストール・パネル DSNTIPP のフィールドPLAN AUTH CACHE の値で、デフォルトは 0 です。




カタログ・レコード: 表 SYSPLAN の列 CACHESIZE。

最適キャッシュ・サイズの決定について詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。

COPY (collection-id.package-id)

(collection-id.package-id) COPYVER

指定先: BIND PACKAGE

既存のパッケージをコピーすることを判別し、そのパッケージを指定します。パッケージをコピーすると、そのコピーにおけるアクセス・パスの再計算が行われます。

リモート・コピーを作成するにあたり、このオプションは SQL ステートメントをローカル・サーバーにあるパッケージからコピーします。そのため、ユーザーはローカル・サーバーでの COPY 特権かそれと同等の特権を保持している必要があります。

collection-id

これは、コピーするパッケージをもつコレクションの名前です。カタログ表SYSPACKAGE の列 COLLID に示されています。

package-id

コピーするパッケージの名前です。カタログ表 SYSPACKAGE の列 NAME に示されています。



COPYVER(version-id)コピーするパッケージのバージョンを判別します。version-id のデフォルトは空ストリングです。

制約事項:

v collection-id.package-id が識別するパッケージは、ローカル・サーバー上のものでなければなりません。

v 同じコレクション内のパッケージにコピーすることはできません。コピーをローカル・サーバーに作成する場合、COPY オプションの collection-id. は、PACKAGE オプションで使用されたコレクションを指すものであってはなりません。

デフォルト:


BIND PLAN 該当せず

BIND PACKAGE なし



COPY にはデフォルトはありません。COPY を使用しない場合には、MEMBER を使用する必要があります。この両方のオプションを使用することはできません。

コピーされたパッケージのオプション値 (ENABLE、DISABLE、OWNER、およびQUALIFIER の値は除く) が、新しいパッケージのバインドにおけるデフォルトになります。BIND PACKAGE コマンドのオプションに新しい値を選ぶことにより、デフォルトをオーバーライドすることが可能です。

リモート・サーバーへのパッケージのコピー: バージョン 8 の新しい BIND オプションをすべてサポートしているとは限らない他のサーバーに、パッケージを DB2

UDB for z/OS バージョン 8 からコピーしてバインドするには、BIND PACKAGE

COPY に新しいオプション OPTIONS(COMMAND) を使用してください。BIND

PACKAGE サブコマンドで明示して指定していないオプションは、すべてそのサーバーのデフォルトに設定されます。このオプションを使用すれば、DB2 UDB for

z/OS バージョン 8 以外のサーバーにパッケージをバインド、コピーする場合にバインド・エラーを避けることができます。

カタログ・レコード: 表 SYSPACKAGE の列 COPY。

CURRENTDATA (YES)

(NO)

指定先: PLAN と PACKAGE のBIND と REBIND、REBIND

TRIGGER PACKAGE

カーソル固定の分離レベルが有効である場合に、読み取り専用のデータの現行性や未確定カーソルを必要とするかを判別します。さらに、分散の未確定カーソルにブロック取り出しを使用できるかを判別します。



カーソルの現在行、ブロック取り出し、およびデータの現行性の更新について詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 4 部を参照してください。

(YES) 読み取り専用および未確定カーソルには、現行でなければならないことを指定します。DB2 は、データが現行のものであるかどうかを検査するために、ページまたは行のロックを獲得します。分散された、未確定カーソルについては、ブロック取り出しが禁止されます。

(NO) 読み取り専用および未確定カーソルに、現行であることが必要でないことを指定します。分散の未確定カーソルについて、ブロック取り出しが許可されます。

アプリケーションが未確定カーソルに対して DELETE WHERE CURRENT

OF ステートメントを動的に準備して実行する場合、そのカーソルがオープンされた後で CURRENTDATA(NO) を使用することはお勧めできません。アプリケーションが以下のいずれかのカーソルに対して、 DELETE

WHERE CURRENT OF ステートメントを試みると、負の値の SQLCODE

を受け取ります。

v ブロック取り出しを使用しているカーソル

v 照会並列処理を使用しているカーソル

v このアプリケーション処理または別のアプリケーション処理により変更されている行に位置付けられているカーソル

リモート再バインドの制約事項: リモート・サーバーでパッケージを再バインドするときには CURRENTDATA を使用できません。CURRENTDATA の値は、以下の方法で変更できます。v リモートから、またはローカルで BIND REPLACE を出すv パッケージを解放した後、リモートから、またはローカルで BIND ADD を出すv パッケージが常駐するロケーションで、ローカルにパッケージを再バインドする

デフォルト:


BIND PLAN YES

BIND PACKAGE YES


REBIND PACKAGE 既存値

カタログ・レコード: 表 SYSPACKAGE の列 DEFERPREP および表 SYSPLAN の列 EXPREDICATE。

CURRENTSERVER (location-name) 指定先: BIND と REBIND PLAN

プランを実行する前の接続先となるロケーションを判別します。カタログ表SYSPLAN 内の列 CURRENTSERVER には、 location-name の値が記録されます。さらに、特殊レジスター CURRENT SERVER もプランの割り振り時には、サーバーにおけるその値を受け取ります。プランが実行されると、リクエスターはそのロケーションに対して明示的にタイプ 1 CONNECT ステートメントを使用します。



CURRENTSERVER を使用すれば、ローカル・アプリケーションは、アプリケーションを変更することなく、リモート・サーバーからデータを使用できるようになります。しかし、CURRENTSERVER を使用するとパフォーマンスが低下するので、できるだけこの使用は避ける必要があります。明示的な CONNECT ステートメントを含んでいるアプリケーションでは、CURRENTSERVER の使用を避けてください。CURRENTSERVER が使用する暗黙のタイプ 1 CONNECT ステートメントが原因で、仮にそのアプリケーションがデフォルトのタイプ 2 でプリコンパイルされていても、アプリケーション内で出される明示的な CONNECT ステートメントがタイプ 1 となってしまうからです。

location-name

接続先ロケーションの名前です。カタログ表 SYSIBM.LOCATIONS には、この名前が入っている必要があります。この表が存在しない場合、この表に DBMS

が入っていない場合、あるいは該当するロケーションにパッケージがない場合には、警告メッセージが出されます。

SQL 戻りコード: CURRENTSERVER によって DB2 はタイプ 1 CONNECT ステートメントを実行します。 DB2 ではアプリケーション・プログラムに対して、この CONNECT が戻すどの警告も表示または報告することはありません。警告を表示するためには、CURRENTSERVER バインド・オプションではなく、明示のCONNECT ステートメントを使用してください。

デフォルト:


BIND PLAN ローカル DBMS (ローカル・ロケーションの名前に関係ない)




カタログ・レコード: 表 SYSPLAN の列 CURRENTSERVER。

DBPROTOCOL (DRDA)

(PRIVATE)

指定先: BIND と REBIND のPLAN と PACKAGE

リモート・サイトに接続する時に使用するプロトコルを指定します。このリモート・サイトは、 3 部分名ステートメントで識別します。

DRDA® の場合、パッケージは、 3 部分名ステートメントが参照する各リモート・サイトにバインドする必要があります。プランまたはパッケージ内の 3 部分名ステートメントが DRDA プロトコルに変換されることを DB2 に知らせるために、DRDA を指定します。

BIND PACKAGE コマンドにオプションを指定すると、BIND PLAN オプションに関係なく、DB2 はパッケージ・ステートメントにそのリモート・アクセス方式を使用します。リモート・バインドの場合、デフォルトはリモート・サイトのシステム・デフォルトです。



BIND PLAN ステートメントにオプションを指定すると、その情報は表 SYSPLAN

に保管されます。

(DRDA)DBPROTOCOL DRDA は、BIND PACKAGE、BIND PLAN、REBIND

PACKAGE、または REBIND PLAN の呼び出し時に渡されます。

(PRIVATE)DBPROTOCOL PRIVATE は、BIND PACKAGE、BIND PLAN、REBIND

PACKAGE、または REBIND PLAN の呼び出し時に渡されます。バージョン 7

以後に DB2 に追加された SQL ステートメントを、 DB2 プライベート・プロトコル・アクセスを使用するアプリケーションに組み込むことはできません。

デフォルト:


BIND PLAN DRDA

BIND PACKAGE システム・デフォルト

REBIND PLAN プランが最後にバインドされた時に指定された値

REBIND PACKAGE プランが最後にバインドされた時に指定された値

カタログ・レコード: 表 SYSPACKAGE と SYSPLAN の列 DBPROTOCOL。

NODEFER(PREPARE)

DEFER(PREPARE)

指定先: BIND と REBIND の PLAN とPACKAGE

リモート・オブジェクトを参照する動的 SQL ステートメントの準備を据え置きにするか、それともすぐに準備を実行するかを判別します。準備を据え置きにすると、動的ステートメントを参照する EXECUTE、OPEN、または DESCRIBE のタイプのステートメントを DB2 が最初に検出した時点で、動的ステートメントの準備が行われます。

BIND と REBIND PACKAGE の場合、どちらのオプションも指定されておらず、しかも REOPT(NONE) が適用される場合、次のようになります。

v ローカル・バインドの場合は、パッケージは実行時にプランのオプションを継承します。

v リモート・バインドの場合は、デフォルトはリモート DB2 サーバーでNODEFER(PREPARE) です。

DEFER も NODEFER も指定しない場合で REOPT(ALWAYS) が適用される場合は、DEFER(PREPARE) がデフォルト値になります。

DEFER(PREPARE) と NODEFER(PREPARE) の両方を同時には使用できません。NODEFER(PREPARE)

準備の据え置きを行いません。DEFER(PREPARE)

準備を据え置きにします。

DEFER(PREPARE) と分散処理: パフォーマンスを向上させるため、DB2 プライベート・プロトコル・アクセスについては動的または静的 SQL のバインド時、DRDA



アクセスについては動的 SQL のバインド時に DEFER(PREPARE) を使用することを検討してみてください。また、バインド・オプション NODEFER(PREPARE) ではなく DEFER(PREPARE) を指定します。DB2 は、動的 SQL ステートメントをそのステートメントを実行するまで準備しません。これによってネットワーク・トラフィックが減少するため、動的 SQL ステートメントのパフォーマンスが向上することになります。

アプリケーション内で SQL ステートメントの準備を据え置きにするには、そのアプリケーションをバインドまたは再バインドする際にオプション DEFER(PREPARE)

を指定します。これにより、リモート・オブジェクトを参照する SQL ステートメントの PREPARE メッセージが以下のいずれかが生じるまで据え置きにされます。v ステートメントが実行されるv アプリケーションが、ステートメントの結果の記述を要求する

PREPARE ステートメントを据え置きすることにした場合、EXECUTE またはDESCRIBE ステートメントの後でその PREPARE ステートメントが戻す可能性のある SQL エラー・コードや SQLSTATE を処理するようアプリケーションをコーディングしなければなりません。PREPARE ステートメントを据え置きにできるのは、バインド・オプション DEFER(PREPARE) を指定した場合に限られます。

デフォルト:


BIND PLAN NODEFER

BIND PACKAGE プラン値



カタログ・レコード: 表 SYSPLAN の列 DEFERPREP および表 SYSPACKAGE の列 DEFERPREPARE。

DEGREE (1)

(ANY)


パフォーマンスを最大にするため、並列処理を利用した照会を実行してみるかどうかを判別します。

プランの場合、DEGREE の値はそのプランに直接バインドされた DBRM (BIND

PLAN の MEMBER オプションに指定) に対してのみ適用され、PKLIST 名には影響しません。また、この値は動的 SQL ステートメントには影響がありません。これは特殊レジスター CURRENT DEGREE の値を使用するためです。この特殊レジスターの値は、SET CURRENT DEGREE ステートメントを実行することで変更可能です。(1) 並列処理を禁止します。(ANY) 並列処理を許可します。

制限: DEGREE=ANY を使用してプランまたはパッケージをバインドする場合、EDM プール内の必要なスペースが 50% ～ 70% 増加する可能性があります。



デフォルト:


BIND PLAN 1

BIND PACKAGE 1



カタログ・レコード: 表 SYSPACKAGE および SYSPLAN の列 DEGREE。

DISCONNECT (EXPLICIT)

(AUTOMATIC)

(CONDITIONAL)


コミット操作時にどのリモート接続を破棄するかを判別します。このオプションは、プランを使用し、任意のタイプのリモート接続を持つすべてのアプリケーション処理に適用されます。このオプションの値に関係なく、コミット操作は解放ペンディング状態のすべての接続を破棄します。SQL ステートメント RELEASE を使用することで、接続を解放ペンディング状態にすることができます。

(EXPLICIT)解放ペンディング状態の接続だけを破棄します。この値を指定すれば、リモート接続の制御を最も柔軟に行うことができます。

(AUTOMATIC)すべてのリモート接続を破棄します。

(CONDITIONAL)WITH HOLD として定義されたオープン・カーソルが関連していない限り、すべてのリモート接続を破棄します。

デフォルト:


BIND PLAN EXPLICIT




カタログ・レコード: 表 SYSPLAN の列 DISCONNECT。

DYNAMICRULES (RUN)

(BIND)

(DEFINEBIND) (BIND および REBIND PACKAGE のみ)

(DEFINERUN) (BIND および REBIND PACKAGE のみ)

(INVOKEBIND) (BIND および REBIND PACKAGE のみ)

(INVOKERUN) (BIND および REBIND PACKAGE のみ)

指定先: BIND とREBIND の PLAN とPACKAGE

次の動的 SQL 属性に実行時にどの値を適用するかを決めます。



v 許可を検査するために使用される許可 ID

v 非修飾オブジェクトに使用される修飾子v 動的 SQL ステートメントを解析し、意味上の検査を行うために DB2 が使用する、アプリケーション・プログラミング・オプションのソース

v 動的 SQL ステートメントが、GRANT、REVOKE、ALTER、CREATE、 DROP、および RENAME ステートメントを組み込むことができるかどうか

DYNAMICRULES 値に加え、パッケージのランタイム環境は、動的 SQL ステートメントが実行時にどのように振る舞うかを制御します。次の 2 つのランタイム環境が考えられます。

v パッケージがスタンドアロン・プログラムの一部として実行される

v パッケージがストアード・プロシージャーまたはユーザー定義関数パッケージとして実行されるか、またはストアード・プロシージャーまたはユーザー定義関数のもとで実行される

DYNAMICRULES 値とランタイム環境の組み合わせにより、動的 SQL 属性の値が決まります。属性値のこのセットは、動的 SQL ステートメントの振る舞いと呼ばれます。これには、次の 4 つの振る舞いがあります。v 実行時の振る舞いv バインドの振る舞いv 定義の振る舞いv 呼び出し時の振る舞い

次の DYNAMICRULES オプションの説明には、それぞれのランタイム環境における動的 SQL ステートメントの振る舞いも含まれています。この情報は 82ページの表 13 に要約されています。

(RUN) 動的 SQL ステートメント用の標準の属性値を使用して、動的 SQL ステートメントを処理します。これはまとめて実行時の振る舞いと呼ばれます。

v 動的 SQL ステートメントの許可検査には、 DB2 はアプリケーション処理の許可 ID と SQL 許可 ID (特殊レジスター CURRENT SQLID の値)

を使用します。

v 表、ビュー、索引、別名の暗黙修飾子として、 DB2 はアプリケーション処理の許可 ID と SQL 許可 ID (特殊レジスター CURRENT SQLID の値) を使用します。

v 動的 SQL ステートメントは、インストール時に指定されたアプリケーション・プログラミング・オプションの値を使用します。インストール・オプション USE FOR DYNAMICRULES は、効力がありません。

v GRANT、REVOKE、CREATE、ALTER、DROP、および RENAME ステートメントは動的に実行できます。

(BIND)次の属性値を使用して、動的 SQL ステートメントを処理します。これはまとめてバインド時の振る舞いと呼ばれます。

v 動的 SQL ステートメントの許可検査にあたって、 DB2 はプランまたはパッケージの許可 ID を使用します。

v 動的 SQL ステートメント内にある非修飾の表、ビュー、索引、別名などは、バインド・オプション QUALIFIER の値で暗黙に修飾されます。な



お、QUALIFIER を指定していない場合には、DB2 はプランまたはパッケージ所有者の許可 ID を暗黙の修飾子として使用します。

v この属性値は、 81ページのバインド時の振る舞い、定義時の振る舞い、呼び出し時の振る舞いに共通な属性値に記述されています。

許可 ID の値および非修飾オブジェクトの修飾子は、組み込みまたは静的SQL ステートメントで使用されるものと同じです。

(DEFINEBIND)2 つの振る舞い、定義時の振る舞いまたは、バインド時の振る舞いのいずれかを使用して、動的 SQL ステートメントを処理します。

パッケージがストアード・プロシージャーまたはユーザー定義関数パッケージとして実行される場合、あるいはストアード・プロシージャーまたはユーザー定義関数の下で実行される場合、DB2 は定義時の振る舞いを使用して動的 SQL ステートメントを処理します。この定義時の振る舞いは、次の属性値からなります。

v アプリケーション・パッケージ内の動的 SQL ステートメントの許可検査に、DB2 はユーザー定義関数またはストアード・プロシージャーの所有者の許可 ID を使用します。

v 修飾されていないオブジェクトのデフォルト修飾子は、ユーザー定義関数またはストアード・プロシージャーの所有者です。

v この属性値は、 81ページのバインド時の振る舞い、定義時の振る舞い、呼び出し時の振る舞いに共通な属性値に記述されています。

パッケージが独立型プログラムとして実行される場合、DB2 はバインド時の振る舞いを使用して動的 SQL ステートメントを処理します。バインド時の振る舞いについては 79ページの『(BIND)』で説明しています。

(DEFINERUN)2 つの振る舞い、定義時の振る舞いまたは、実行時の振る舞いのいずれかを使用して、動的 SQL ステートメントを処理します。

パッケージがストアード・プロシージャーまたはユーザー定義関数パッケージとして実行されるか、あるいはストアード・プロシージャーまたはユーザー定義関数の下で実行される場合、動的 SQL ステートメントは定義時の振る舞いを持ちます。定義時の振る舞いについては『(DEFINEBIND)』で説明しています。

パッケージが独立型プログラムとして実行される場合、DB2 は実行時の振る舞いを使用して動的 SQL ステートメントを処理します。実行時の振る舞いについては 79ページの『(RUN)』で説明しています。

(INVOKEBIND)2 つの振る舞い、起動時の振る舞いまたは、バインド時の振る舞いのいずれかを使用して、動的 SQL ステートメントを処理します。

パッケージがストアード・プロシージャーまたはユーザー定義関数パッケージとして実行される場合、あるいはストアード・プロシージャーまたはユーザー定義関数の下で実行される場合、DB2 は起動時の振る舞いを使用して動的 SQL ステートメントを処理します。この定義時の振る舞いは、次の属性値からなります。



v アプリケーション・パッケージ内の動的 SQL ステートメントの許可検査に、DB2 はユーザー定義関数またはストアード・プロシージャーの起動側の許可 ID を使用します。

起動側が処理の 1 次許可 ID であるか、または CURRENT SQLID 値である場合、必要な許可において 2 次許可 ID も必要ならば検査されます。そうでない場合、1 つだけの ID、つまり起動側の ID が、必要な許可に照らして検査されます。

v 修飾されていないオブジェクトのデフォルト修飾子は、ユーザー定義関数またはストアード・プロシージャーの起動側です。

v この属性値は、バインド時の振る舞い、定義時の振る舞い、呼び出し時の振る舞いに共通な属性値に記述されています。

パッケージが独立型プログラムとして実行される場合、DB2 はバインド時の振る舞いを使用して動的 SQL ステートメントを処理します。バインド時の振る舞いについては 79ページの『(BIND)』で説明しています。

(INVOKERUN)2 つの振る舞い、起動時の振る舞いまたは、実行時の振る舞いのいずれかを使用して、動的 SQL ステートメントを処理します。

パッケージがストアード・プロシージャーまたはユーザー定義関数パッケージとして実行される場合、あるいはストアード・プロシージャーまたはユーザー定義関数の下で実行される場合、DB2 は動的 SQL ステートメントを呼び出し時の振る舞いを使用して処理します。呼び出し時の振る舞いについては 80ページの『(INVOKEBIND)』で説明しています。

パッケージが独立型プログラムとして実行される場合、DB2 は実行時の振る舞いを使用して動的 SQL ステートメントを処理します。実行時の振る舞いについては 79ページの『(RUN)』で説明しています。

バインド時の振る舞い、定義時の振る舞い、および呼び出し時の振る舞いに共通な属性値: 次の属性値は、バインド時、定義時、または呼び出し時の振る舞いを持つ、プランまたはパッケージ内の動的 SQL ステートメントに適用されます。

v どのような DYNAMICRULES 値でバインドされたパッケージやプランでも、ステートメント SET CURRENT SQLID を実行することができます。ただし、DB2

は CURRENT SQLID の値を動的 SQL ステートメントの許可 ID として使用しません。

DB2 は常に CURRENT SQLID の値を、 PLAN_TABLE の EXPLAIN 出力の修飾子として使用します。(CURRENT SQLID 値が PLAN_TABLE の別名を持ち、かつ適切な特権を持っている場合は、その PLAN_TABLE にデータが追加されます。)

v インストール・オプション USE FOR DYNAMICRULES の値が YES の場合、DB2 はインストール中に指定されたアプリケーション・プログラミングのデフォルト値を使用して、動的 SQL ステートメントの解析と意味上の検査を行います。USE FOR DYNAMICRULES 値が NO の場合、DB2 はプリコンパイラー・オプションを使用して、動的 SQL ステートメントの構文解析と意味上の検査を行います。USE FOR DYNAMICRULES オプションが影響するアプリケーション・プログラミング・デフォルトのリストについては、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。



v GRANT、REVOKE、CREATE、ALTER、DROP、および RENAME ステートメントは動的に実行できません。

リモート DB2 サーバー: DRDA アクセスを使用するパッケージの場合、DB2 はバインド時に DYNAMICRULES オプションを DB2 サーバーに送ります。

DB2 プライベート・プロトコル・アクセスを使用するプランまたはパッケージの場合、DB2 は次の規則を使用して、実行時に DYNAMICRULES 値 BIND またはRUN をサーバーに送ります。

v パッケージをバインドする DYNAMICRULES 値が BIND、DEFINEBIND、または INVOKEBIND の場合、DB2 は値 BIND をサーバーに送ります。

v パッケージをバインドする DYNAMICRULES 値が RUN、DEFINERUN、またはINVOKERUN の場合、DB2 は値 RUN をサーバーに送ります。

表 13 は、それぞれの振る舞いの動的 SQL ステートメント属性値を要約しています。DYNAMICRULES オプションによる影響を受ける動的 SQL 属性について詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。

表 13. 動的 SQL ステートメントの動作の定義

動的 SQL 属性バインド時の振る舞いの値

実行時の振る舞いの値

定義時の振る舞いの値起動時の振る舞いの値

許可 ID パッケージOWNER

現行 SQLID ユーザー定義関数またはストアード・プロシージャーの所有者

呼び出し側の許可 ID

修飾されていないオブジェクトのデフォルト修飾子

バインド OWNER

または QUALIFIER

値

現行 SQLID ユーザー定義関数またはストアード・プロシージャーの所有者

呼び出し側の許可 ID

CURRENT SQLID 1 次 authid に初期化。SET SQLID は可能。

1 次 authid に初期化。SET SQLID は可能。



アプリケーション・プログラミング・オプションのソース

DSNHDECP パラメーター DYNRULS

により決まる

インストール・パネル DSNHDECP

アプリケーションのデフォルト

DSNHDECP パラメーター DYNRULS により決まる

DSNHDECP パラメーター DYNRULS により決まる

GRANT、REVOKE、CREATE、ALTER、DROP、RENAME を実行できるか ?

いいえはいいいえいいえ

デフォルト:


BIND PLAN RUN






リモート・サーバー上のパッケージのデフォルトは RUN です。

カタログ・レコード: 表 SYSPACKAGE および SYSPLAN の列DYNAMICRULES。

ENABLE

DISABLE

(*)

(BATCH)

(CICS)

(CICS) CICS(applid, ...)

(DB2CALL)

(DLIBATCH)

(DLIBATCH) DLIBATCH(connection-name, ...)

(IMS)

(IMSBMP)

(IMSBMP) IMSBMP(imsid, ...)

(IMSMPP)

(IMSMPP) IMSMPP(imsid, ...)

(REMOTE) (BIND および REBIND PACKAGE のみ)

(REMOTE) REMOTE (location-name,..., < luname>,...)

(RRSAF)

指定先: BIND と REBIND

の PLAN と PACKAGE

どの接続がプランまたはパッケージを使用できるかを判別します。DISABLE とENABLE の両方を使用することはできません。パッケージの場合、DISABLE とENABLE が有効なのはローカル・バインド操作に限られます。

ENABLEプランまたはパッケージを使用できるシステム接続タイプのリストを指定します。指定されていない接続タイプは使用できません。

DISABLEプランまたはパッケージを使用できないシステム接続タイプのリストを指定します。指定されていない接続タイプは使用できます。

いくつかの接続タイプとともに接続 ID をリストに指定して、使用可能または使用不可にするタイプの特定の接続を識別することができます。接続 ID を使用不可として指定すると、同じ接続タイプに指定されていない接続はいずれも使用可能になります。接続 ID を使用可能として指定すると、同じ接続タイプに指定されていない接続はいずれも使用不可になります。

接続 ID が有効になるのは、対応する接続タイプを指定しているキーワードの後に限られます。

接続タイプ:

(*) すべての有効な接続タイプを指定します。ENABLE に限り使用できます。

(BATCH)プランまたはパッケージに対して、すべての TSO 接続が使用可能または使用禁止のいずれかであることを示します。



(CICS)CICS Connection® (CICS 接続) を識別します。プランまたはパッケージに対して、CICS SIT テーブルに指定されたすべての CICS VTAM ノード名は、使用可能または使用禁止にされます。

(CICS) CICS(applid, ...)CICS SIT テーブルの APPLID パラメーターに指定された CICS VTAM ノード名を識別します。applid で指定された CICS VTAM ノードは、プランまたはパッケージに対して使用可能または使用禁止にされます。

(DB2CALL)呼び出し接続機能 (CAF) がプランまたはパッケージに対して使用可能、または使用禁止であることを示します。

(DLIBATCH)データ言語 /I (DL/I) バッチ・サポート機能の接続を識別します。DL/I バッチ・サポート・システムが持つ必要のある JCL の、 DDITV02 データ・セットまたはジョブ名からの接続 ID はすべて、プランまたはパッケージに対して使用可能または使用禁止にされます。

(DLIBATCH) DLIBATCH(connection-name, ...)接続 ID を指定します。接続 ID は DL/I バッチ・サポート・システムが持つ必要のある JCL 内の DDITV02 データ・セットまたはジョブ名からのものです。connection-name で指定された DL/I バッチ接続は、プランまたはパッケージに対して使用可能または使用禁止にされます。

(IMS)すべての情報管理システム (IMS) 接続、DLIBATCH、IMSBMP、およびIMSMPP がプランまたはパッケージに対して使用可能、または使用禁止であることを指定します。

(IMSBMP)バッチ・メッセージ・プログラム (BMP) 領域の IMS 接続を指定します。CTL

パラメーター EXEC 上の IMSID の値で指定された、すべての IMS BMP 接続は、プランまたはパッケージに対して使用可能または使用禁止にされます。

(IMSBMP) IMSBMP(imsid, ...)CTL パラメーター EXEC 上の IMSID の値を指定します。imsid で指定されたIMS BMP バッチ接続は、プランまたはパッケージに対して使用可能または使用禁止にされます。

(IMSMPP)メッセージ処理プログラム (MPP) および IMS 高速パス (IFP) 領域用の IMS

接続を指定します。CTL パラメーター EXEC 上の IMSID の値で指定された、すべての IMS MPP 接続は、プランまたはパッケージに対して使用可能または使用禁止にされます。

(IMSMPP) IMSMPP(imsid, ...)CTL パラメーター EXEC 上の IMSID の値を指定します。imsid で指定されたIMS MPP 接続は、プランまたはパッケージに対して使用可能または使用禁止にされます。



(REMOTE)プランまたはパッケージに対して、すべてのリモート接続が使用可能または使用禁止のいずれかであることを示します。

(REMOTE) REMOTE (location-name,...,< luname>,...) (PACKAGE only)

以下により指定されたリモート接続が、パッケージに対して使用可能または使用禁止のいずれかであることを示します。

location-name

DB2 UDB for z/OS サブシステムである要求 DBMS のロケーション名を指定します。

< luname>DB2 UDB for z/OS サブシステムではない要求 DBMS の (サーバーのロケーションで VTAM に定義されている) 論理装置名を指定します。

論理装置名はロケーション名と区別するために、より小さい (<) とより大きい (>) 文字で囲む必要があります。

(RRSAF)RRS 接続機能の接続が、プランまたはパッケージに対して使用可能または使用禁止のいずれかであることを示します。

パフォーマンス上のヒント: プランまたはパッケージが割り振られると、DB2 では、必ず使用可能または使用禁止の接続のリストに照らして、その接続タイプと接続名を検査します。最良のパフォーマンスを出すにはこのリストを短くしてください。

システムを使用不可にするプラン: プランによってシステムが使用不可になると、そのプランに付加されたパッケージはすべて、ENABLE/DISABLE オプションに関係なく、そのシステムから実行することはできません。ただし、同じパッケージが他のプランに追加されていて、そのプランでシステムを使用可能にする場合は、そのパッケージはそのプランの下でそのシステムから実行可能です。

デフォルト:


BIND PLAN ENABLE(*)

BIND PACKAGE ENABLE(*)



カタログ・レコード: パッケージについては表 SYSPKSYSTEM、プランについては表 SYSPLSYSTEM。

ENCODING (ASCII)

(EBCDIC)

(UNICODE)

(ccsid)


プランまたはパッケージ内にある静的ステートメントのすべてのホスト変数に対してアプリケーション・エンコードを指定します。EBCDIC は、DB2 バージョン 6



#

#

以前でプリコンパイルされたプランまたはパッケージに対してのみ有効なオプションです。 V7 より前にプリコンパイルされたプランまたはパッケージで ccsid を指定した場合、ccsid の値はインストール・パネル DSNTIPF (SYSTEM EBCDIC

CCSID) 上で指定された EBCDIC ccsid と一致する必要があります。ASCII、UNICODE、または ccsid を指定できます。ここで ccsid は、V7 以降でプリコンパイルされたプランまたはパッケージに対する SYSTEM EBCDIC ccsid 以外の値です。データ・ソース (端末エミュレーターなど) が SYSTEM EBCDIC ccsid と異なる ccsid を使用する場合、このオプションを選択しても構いません。例えば、1047

の ccsid を使用する端末エミュレーターをユーザーが保有していても、SYSTEM

EBCDIC CCSID は 37 です。この場合、そのユーザーが使用予定のプランまたはパッケージは、ENCODING (1047) でバインドされる必要があります。

ENCODING は、SQL ステートメント DESCRIBE によって戻されるデータの内容にも影響を与えます。DB2 は、指定されたアプリケーションのコード化スキームで、列名、ラベル名、またはその両方 (要求された場合) を戻します。DESCRIBE

の詳細については、「DB2 SQL 解説書」を参照してください。

Unicode については、「DB2 インストレーション・ガイド」の Unicode サポートに関する付録を参照してください。

デフォルト: パッケージのアプリケーションのコード化スキームのデフォルトは、プランのアプリケーション・エンコード・オプションから継承されません。リモート DB2 UDB for z/OS システムにバインドされたパッケージのデフォルトは、リモート・サーバーのデフォルトのアプリケーションのコード化スキームになります。同様に、プランまたはパッケージがリモート DB2 UDB for z/OS サーバー上で実行される場合、指定された ENCODING オプションは無視されます。代わりに、リモート・サーバーのコード化スキームが使用されます。


BIND PLAN インストール時に指定されたシステム・デフォルトのアプリケーション・コード化スキーム

BIND PACKAGE インストール時に指定されたシステム・デフォルトのアプリケーション・コード化スキーム

REBIND PLAN プランまたはパッケージが最後にバインドされたときに指定された値

REBIND PACKAGE プランまたはパッケージが最後にバインドされたときに指定された値

製品固有プログラミング・インターフェース

EXPLAIN (NO)

(YES)

指定先: PLAN と PACKAGE の BIND

と REBIND、REBIND TRIGGER

PACKAGE

このオプションを使って、パッケージ内の SQL ステートメントまたは、プランのメンバー・リスト内の SQL ステートメントがどのように実行されるかについての情報を入手します。このオプションを指定すると、その情報が表owner.PLAN_TABLE に挿入されます。Owner を、プランまたはパッケージの所有



#

#

#

#

#

#

#

#

#

#

#

|

|

|

|

|

|

|

|

者の許可 ID にすることができます。あるいは、プランまたはパッケージの所有者の許可 ID に、基本表 PLAN_TABLE をポイントする owner.PLAN_TABLE を別名として含めることができます。Owner は、その表に関する適切な SELECT およびINSERT 特権も持っていなければなりません。このオプションは、リモート・オブジェクトにアクセスするステートメントの情報は入手しません。

PLAN_TABLE は基本表を持っていなければなりません。また、同じ表名PLAN_TABLE の付いた複数の別名を持つことができますが、使用する authid は異なります。PLAN_TABLE はビューまたは同義語にすることはできません。また、これはバインド処理が始まる前に存在している必要があります。

EXPLAIN オプションは、2 つのオプションの表 DSN_STATEMNT_TABLE とDSN_FUNCTION_TABLE にも (存在すれば) データを追加します。

DSN_STATEMNT_TABLE には、DB2 が見積もった SQL ステートメントの処理コストが含まれています。詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 6 部を参照してください。

DSN_FUNCTION_TABLE には、関数解決についての情報が含まれています。詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 3 部を参照してください。

EXPLAIN(NO) でバインドしたプログラムに組み込まれているステートメントのEXPLAIN 出力を得るには、プログラムに SQL ステートメント EXPLAIN を組み込みます。そうしない場合、EXPLAIN オプションの値はプログラム内の EXPLAIN

可能なすべての SQL ステートメントに、また DECLARE CURSOR ステートメントの全選択部分に適用されることになります。

owner.PLAN_TABLE へのすべての挿入内容の中で、QUERYNO の値はプリコンパイラーが DBRM 内に割り当ておよび指定したステートメント番号です。

EXPLAIN オプションによってデータを追加される表についての説明は、「DB2

SQL 解説書」第 5 章の EXPLAIN ステートメントに関する説明を参照してください。

自動再バインドの場合: EXPLAIN(YES) が有効になるのは、プランやパッケージをEXPLAIN(YES) でバインドし、しかもインストール・パネル DSNTIPO のフィールド EXPLAIN PROCESSING の値が YES になっている場合です。EXPLAIN(YES)

と VALIDATE(BIND) が有効であっても PLAN_TABLE が正しくない場合、自動再バインドは失敗します。

(NO) EXPLAIN 情報を提供しません。

(YES) EXPLAIN で指定された表に情報を挿入します。バインド時にowner.PLAN_TABLE が存在しない場合、オプション VALIDATE の値によってバインド操作が成功するかどうかが決まります。

v 値が BIND の場合、バインドは失敗します。

v 値が RUN の場合、DB2 では、ランタイムに再びその表が存在するか否かを検査します。まだ存在していなければ、プランまたはパッケージは実行できません。表が存在している場合、DB2 ではプランまたはパッケージの実行前に、情報を表 PLAN_TABLE に挿入します。



オプションの表 DSN_FUNCTION_TABLE またはDSN_STATEMNT_TABLE の両方とも存在しない、または両方とも存在する場合、あるいは誤って定義されている場合、バインドは失敗しません。

再バインドに失敗した結果起こる無効化: 再バインドの失敗で 4 より大きい戻りコードが生成されると、再バインド・オブジェクトは無効になり、そのオブジェクトに対するすべての変更はロールバックされ、再バインドを試みる前の状態のままとなります。しかし、再バインドが REBIND オプション EXPLAIN または SQL ステートメント EXPLAIN のいずれかが原因で失敗した場合 (つまり、PLAN_TABLE

が存在しないか、正しく作成されていなかった場合)、DB2 はそのオブジェクトに対するすべての変更をロールバックしますが、オブジェクトを無効にはしません。

デフォルト:


BIND PLAN NO

BIND PACKAGE NO



カタログ・レコード: 表 SYSPACKAGE の列 EXPLAIN、および表 SYSPLAN の列EXPLAN

製品固有プログラミング・インターフェースの終り

FLAG (I)

(W)

(E)

(C)


TRIGGER PACKAGE

表示するメッセージを判別します。

(I) すべての、通知メッセージ、警告メッセージ、エラー・メッセージ、および完了メッセージ

(W) 警告、エラー、完了の各メッセージのみ。

(E) エラーと完了のメッセージのみ。

(C) 完了メッセージのみ

複数のプランまたはパッケージの再バインド: REBIND コマンドにアスタリスク (*)

が含まれていて、多数のプランやパッケージに影響する場合、メッセージの記憶域が足りなくなるのを避けるために、FLAG(E) を指定することが推奨されます。

デフォルト:


BIND PLAN I

BIND PACKAGE I

REBIND PLAN I



REBIND PACKAGE I

IMMEDWRITE (NO)

(YES)


グループ・バッファー・プールに従属するページ・セットまたはパーティションに対して行った更新について即時書き込みを実行するかどうかを示します。このオプションは、データ共用環境にのみ適用されます。IMMEDWRITE サブシステム・パラメーターは、バインド時の IMMEDWRITE バインド・オプションには影響を与えません。表 14 は、このオプションが実行時に影響を与える暗黙の階層を示しています。 IMMEDWRITE オプションの値は次のものです。

(NO) 通常の書き込みアクティビティーが行われることを指定します。グループ・バッファー・プールに従属する更新ページの書き込みを、コミットのフェーズ 1 またはそれ以前に、あるいはロールバックされたトランザクションの打ち切りの終了時に行います。

(YES) グループ・バッファー・プールに従属する更新ページがバッファーの更新の完了後すぐに書き込まれることを指定します。バッファーがトランザクションの進行中またはロールバック中に更新される場合でも、更新ページへの書き込みは即時に行われます。このオプションを指定すると、パフォーマンスに影響がある場合があります。

表 14. IMMEDWRITE オプションの暗黙の階層

IMMEDWRITE

バインド・オプションIMMEDWRI

サブシステム・パラメーターランタイムの値

NO NO NO

NO PH1 PH1

NO YES YES

PH1 NO PH1

PH1 PH1 PH1

PH1 YES YES

YES NO YES

YES PH1 YES

YES YES YES

注: NO オプションと PH1 オプションは同じです。PH1 オプションは、後方互換性の場合にのみ記載してあります。

パフォーマンス上のヒント: IMMEDWRITE(PH2) および IMMEDWRITE(YES) を使用できる状況とは、あるトランザクションが別トランザクションを発生させる場合で、その別トランザクションが異なる DB2 メンバー上で実行する可能性があり、発生元のトランザクションが行った非コミットの更新に依存しているという場合です。

IMMEDWRITE(PH2) を指定すると、グループ・バッファー・プールに従属するページは、コミットのフェーズ 1 の時点、またはそれ以前に書き込まれることになります。



|

|

|

|

|

|

|

|

|

IMMEDWRITE(YES) を指定すると、元のトランザクションはその更新された GBP

従属バッファーを (コミットまたはロールバックの終了まで待たずに) 即時に書き込むことになります。この結果、従属するトランザクションは、元のトランザクションと同じメンバー上で実行するか別のメンバー上で実行するかに関係なく、常に同じ結果を確実に得ることができます。IMMEDWRITE(YES) は、パフォーマンスに影響を与える可能性があるので、注意して使用すべきです。この影響は、GBP 従属ページに多くのバッファー更新を行うプランやパッケージには重大ですが、GBP 従属ページへのバッファー更新が少ししかないプランやパッケージでは気にするほどではないでしょう。次のオプションは、 IMMEDWRITE(YES) の使用に代わる代替案と考えられます。

v 従属トランザクションを常に元のトランザクションと同じ DB2 メンバー上で実行する。

v 従属トランザクションを ISOLATION(RR) で実行する。

v コミットのフェーズ 2 が完了するまで待ってから、従属トランザクションを生成する。

v CURRENTDATA(YES) または ISOLATION(RS) が問題の解決に使用できるのは、元のトランザクションが、従属トランザクションの WHERE 文節にない列を更新する場合だけです。

デフォルト:


BIND PLAN NO

BIND PACKAGE NO



リモート DB2 サーバー上のパッケージ用のデフォルトは IMMEDWRITE(NO) です。

ISOLATION (RR)

(RS)

(CS)

(UR)

(NC)


TRIGGER PACKAGE

アプリケーションを、実行中の別のアプリケーションの影響からどの程度分離するかを判別します。分離レベルについて詳しくは、「DB2 管理ガイド」第 5 部 (第 2

巻) の並行性の改善を参照してください。

(RR) 反復可能読み取り。以下の点が保証されます。

v 別の処理が変更した行を、その処理が解放するまでアプリケーションが読み取らない。

v アプリケーションが読み取る行を、そのアプリケーションがコミットまたは終了するまで他の処理が変更しない。

(RS) 読み取り固定。以下の点が保証されます。



v 別の処理が変更した行を、その処理が解放するまでアプリケーションが読み取らない。

v 他の処理はユーザーのアプリケーションがコミットするかまたは終了するまで、当該アプリケーションの探索条件を満足する行は変更しません。他のアプリケーション処理では、行を挿入したり、探索条件を最初に満足しなかった行を変更したりすることはできます。

サーバーが RS をサポートしていない場合は、RR を使用します。

(CS) カーソル固定。反復可能読み取りと同様、カーソル固定では、別の処理が変更した行を、その処理が行を解放するまでアプリケーションが読み取らないようにします。カーソル固定が反復可能読み取りとは異なる点として、アプリケーションが読み取る行をプログラムがコミットまたは終了するまで他のアプリケーションが変更しないようにすることはありません。

(UR) 非コミット読み取り。反復可能読み取りやカーソル固定とは異なり、非コミット読み取りで保証されることはなにもありません。LOB データを除き、非コミット読み取りでは、データにロックを獲得せずにすみ、次のことを可能にします。

v このアプリケーションが読み取る任意の行を、作業単位中に、他の処理が変更する。

v 他の処理が変更した行を、処理がその行をコミットしていなくても、アプリケーションで読み取る。

このオプションを使用できるのは、読み取り専用操作の場合、および読み取り専用カーソルを使用する SELECT、SELECT INTO、あるいは FETCH の場合だけです。それ以外の操作に ISOLATION(UR) を指定すると、DB2 はその操作に対して ISOLATION(CS) を使用します。

(NC) コミットなし。DB2 UDB for z/OS 以外の特定のサーバーにバインドされたパッケージ上で使用されます。DB2 UDB for z/OS では NC をサポートしていません。サーバーがこの分離レベルをサポートしていなければ、UR が使用されます。

ロックと並行性にオプション ISOLATION がどのような影響を与えるかについては(プランに指定された値とパッケージに指定された値が異なる場合に DB2 が最も制限の厳しい値を使用して競合を解決する方法も含む)、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 4 部を参照してください。

デフォルト:


BIND PLAN RR




パッケージをリモート・サーバーにバインドする場合のデフォルトは RR です。



REBIND PACKAGE の場合、ISOLATION を指定の値からプラン値のデフォルトへREBIND PACKAGE を使用して変更することはできません。これを行うには、BIND PACKAGE ACTION(REPLACE) を使用することが必要です。

カタログ・レコード: 表 SYSPACKAGE および SYSPLAN の列 ISOLATION。

KEEPDYNAMIC (NO)

(YES)


コミット・ポイント以後も、DB2 が動的 SQL ステートメントを保存するかどうかを決定します。

(NO) コミット・ポイント以後も DB2 が動的 SQL ステートメントを保存しないことを指定します。

(YES) コミット・ポイント以後は DB2 が動的 SQL ステートメントを保存することを指定します。

KEEPDYNAMIC(YES) を指定する場合は、アプリケーションでは各コミット・ポイントの後に SQL ステートメントを準備する必要はありません。DB2 では、以下のいずれかが発生するまで動的 SQL ステートメントを保存します。

v アプリケーション処理が終了する。

v ロールバック操作が実行される。

v アプリケーションで、同じステートメント ID が指定されている明示的なPREPARE ステートメントを実行する。

KEEPDYNAMIC(YES) を指定する場合で、作成されたステートメント・キャッシュがアクティブの場合、 DB2 では作成されたステートメントのコピーをキャッシュに保存します。作成されたステートメント・キャッシュがアクティブでない場合は、DB2 はコミット・ポイント以後は SQL ステートメント・ストリングだけを保存します。その後、アプリケーションがそのステートメントに対して OPEN、EXECUTE、または DESCRIBE 操作を実行すると、DB2 では暗黙的に SQL ステートメントを準備します。

KEEPDYNAMIC(YES) を指定する場合は、KEEPDYNAMIC(YES) パッケージを実行するために使用する DDF サーバー・スレッドがアクティブのままになります。アクティブな DDF サーバー・スレッドは、アイドル状態のスレッド・タイムアウトの対象となります (インストール・パネル「DSNTIPR」に関する「DB2 インストール・ガイド」第 2 部を参照)。

KEEPDYNAMIC(YES) を指定する場合は、REOPT(ALWAYS) を指定しないでください。KEEPDYNAMIC(YES) と REOPT(ALWAYS) は、同時には指定できません。ただし、REOPT(ONCE) を指定して KEEPDYNAMIC(YES) を使用できます。

パフォーマンス上のヒント: DRDA クライアント・アプリケーションが WITH

HOLD と定義されたカーソルを使用する場合は、KEEPDYNAMIC(YES) を使用することでパフォーマンスが向上します。取り出す行がなくなった時点で DB2 は保留されているカーソルを自動的にクローズします。これにより、余分なネットワーク・メッセージは出力されなくなります。

デフォルト:




BIND PLAN NO

BIND PACKAGE NO



リモート DB2 サーバー上のパッケージのデフォルトは KEEPDYNAMIC です。

カタログ・レコード: 表 SYSPLAN および SYSPACKAGE の列 KEEPDYNAMIC。

LIBRARY (dbrm-pds-name)

(dbrm-pds-name, ...) (BIND PLAN のみ)

指定先: BIND PLAN、BIND

PACKAGE

MEMBER オプションに指定された DBRM をどの区分データ・セット (ライブラリー) で検索するかを判別します。ライブラリーはカタログされていることが必要です。

バインド処理は、指定されている順序でライブラリーを検索します。MEMBER オプションに指定された DBRM のあるものがライブラリーに含まれておらず、DBRMLIB DD には JCL ステートメントが存在していると、この処理は JCL ステートメントに記述されたライブラリーを検索します。

dbrm-pds-name は、ライブラリーのデータ・セット名です。

BIND PACKAGE の場合、検索するライブラリーは 1 つだけ指定できます。

BIND PLAN の場合、1 つ以上の検索ライブラリーを指定することができます。

デフォルト:


BIND PLAN なし

BIND PACKAGE なし



デフォルトは、DBRMLIB の DD ステートメントに記述されたライブラリーだけを検索するというものです。

MEMBER (dbrm-member-name)

(dbrm-member-name, ...) (BIND PLAN のみ)

指定先: BIND

PLAN、BIND PACKAGE

プランまたはパッケージに、どのデータベース要求モジュール (DBRM) を含めるかを判別します。

dbrm-member-name

DBRM を含んでいるライブラリー・メンバーの名前を指定します。DBRM がメンバーとなっている区分データ・セットは LIBRARY オプションに、またはDBRMLIB DD の JCL ステートメントに指定できます。



BIND PACKAGE の場合のみ、その名前はパッケージ名となります。DSN で始まる名前は予約済みであるため、そのような名前を使用すると警告メッセージを受け取ります。

BIND PACKAGE の場合、使用できるメンバーは 1 つだけです。MEMBER を使用しない場合には、COPY を使用する必要があります。この両方のオプションを使用することはできません。

BIND PLAN の場合、リストには多数のメンバーを指定できます。DB2 はそのメンバー・リストをアルファベット順にソートします。MEMBER を使用しない場合には、 PKLIST を使用する必要があります。

デフォルト:


BIND PLAN なし

BIND PACKAGE なし



カタログ・レコード: BIND PACKAGE のための表 SYSPACKAGE または BIND

PLAN のための表 SYSDBRM の列 NAME。

OPTHINT ('hint-id') 指定先: BIND と REBIND のPLAN と PACKAGE

照会最適化ヒントを静的 SQL に使用するかどうかを制御します。

('hint-id')128 文字までの長さの文字ストリングであり、最適化プログラムはこれを使用して、最適化プログラムへの入力として使用する行を PLAN_TABLE から探します。区切り文字として使用できるのは、単一引用符 (') だけです。

'hint-id' がすべてブランク文字の場合、DB2 は最適化のヒントを静的 SQL

ステートメントに使用しません。

DB2 は、最適化のヒントがシステムで使用可能になっている場合のみ最適化ヒントを使用します。最適化のヒントを使用可能にするには、インストール・パネルDSNTIP4 の OPTIMIZATION HINTS フィールドに YES を指定します。

OPTHINT オプションの使用について詳しくは、「DB2 管理ガイド」第 5 部 (第 2


制約事項: PACKAGE は PLAN から継承しないことに注意してください。

デフォルト:


BIND PLAN すべてブランク。通常の最適化を使用

BIND PACKAGE すべてブランク。通常の最適化を使用



|



リモート・サーバー上のパッケージのデフォルトは、すべてブランクです。

カタログ・レコード: 表 SYSPLAN および SYSPACKAGE の列 OPTHINT。

OPTIONS (COMPOSITE)

(COMMAND)

指定先: BIND PACKAGE COPY

新しいパッケージに対してどのバインド・オプションを使用するかを指定します。COMPOSITE

新しいパッケージに対するオプションは、BIND PACKAGE COPY サブコマンドに指定したものです。指定されていないオプションは、コピーすべきソース・パッケージを記述する SYSPACKAGE カタログ表の行から持ってきたオプション値になります。リモート・コピーの場合、OPTIONS(COMPOSITE) は、リモート DB2 サブシステムが DB2 UDB for

z/OS バージョン 8 である場合にのみ有効です。COMMAND

新しいパッケージに対するオプションは、BIND PACKAGE COPY サブコマンドに指定したものです。指定されていないオプションは、以下のようにして判別されます。v ローカル・コピーの場合、DB2 定義の BIND PACKAGE オプションのデフォルトが使用されます。

v リモート・コピーの場合、サーバー定義の BIND PACKAGE オプションのデフォルトがサーバーで使用されます。下位レベルのサーバーまたは非z/OS DB2 サーバーにコピーする場合は、OPTIONS(COMMAND) を使用する必要があります。下位レベルのサーバーとは、DB2 UDB for z/OS

バージョン 8 でないサーバーです。

デフォルト:


BIND PACKAGE COPY COMPOSITE

OWNER (authorization-id) 指定先: BIND と REBIND のPLAN と PACKAGE

オブジェクト (プランまたはパッケージ) の所有者の許可 ID を判別します。この所有者は、そのオブジェクトに含まれている SQL ステートメントを実行するのに必要な特権を有していなければなりません。

所有権に変更が生じると、オブジェクトに対して以前の所有者が出した特権のすべての認可は、新しい所有者を認可者として示すよう変更されます。新しい所有者はそのオブジェクトに対する BIND 特権および EXECUTE 特権を有し、それらを以前の所有者に認可します。



|

|

|

|

|

バインドまたは再バインドできるのは、許可 ID がバインド特権を有しているオブジェクトだけです。許可 ID を指定しない場合、1 次許可 ID がバインド特権を有するオブジェクトだけが処理によって再バインドされます。

リモート BIND または REBIND PACKAGE の場合のみ、OWNER の値はリモート・システム送信時に変換されます。

デフォルト:


BIND PLAN 1 次 ID

BIND PACKAGE 1 次 ID



デフォルトの所有者は、バインド処理を実行するエージェントの 1 次許可 ID です。

カタログ・レコード: 表 SYSPACKAGE の列 OWNER、表 SYSPACKAUTH の列GRANTOR、および表 SYSPLAN の列 CREATOR。

PACKAGE (location-name.collection-id.package-id.(version-id))

(*) (REBIND PACKAGE のみ)

指定先: BIND PACKAGE

および REBIND PACKAGE

バインドまたは再バインドするパッケージ (1 つ以上) を判別します。

BIND PACKAGE サブコマンドは次のことには使用できません。v パッケージを既存のトリガー・パッケージと同じ名前でバインドするv トリガー・パッケージをコピーする

以下のオプションは、ロケーション、コレクション、パッケージ名、およびパッケージのバージョンを識別するものです。ロケーションとコレクションを識別することができます。BIND の場合、オプション MEMBER を使用すると DBRM がパッケージ ID とバージョン ID を提供し、あるいはオプションのそれらの ID はCOPY から取られます。REBIND の場合、パッケージ名を識別する必要があり、またバージョン ID を指定することが可能です。

location-name

パッケージがバインドまたは再バインドされる、またそのパッケージの記述が置かれる DBMS のロケーションです。ロケーション名は、カタログ表SYSIBM.LOCATIONS で定義されている必要があります。この表が存在しないか、DBMS がその中にない場合はエラー・メッセージが出されます。

デフォルトは、ローカル DBMS です。

collection-id または *バインドするパッケージを入れるコレクション、または再バインドするパッケージをすでに含んでいるコレクションを指定します。デフォルトはありません。



REBIND の場合、アスタリスク (*) を使用すれば自分がバインド特権を有するすべてのコレクションにおいて指定された package-id をもつすべてのローカル・パッケージを再バインドできます。

package-id または * (REBIND の場合のみ)カタログ表 SYSPACKAGE の列 NAME のリストに従い、再バインドするパッケージ名を指定します。デフォルトはありません。

アスタリスク (*) を使用すれば、自分がバインド特権を有する collection-id のすべてのローカル・パッケージを再バインドできます。

version-id または * (REBIND の場合のみ)カタログ表 SYSPACKAGE の列 VERSION のリストに従い、再バインドするパッケージのバージョンを指定します。

アスタリスク (*) を使用すれば、自分がバインド特権を有する collection-id の指定された package-id のすべてのローカル・バージョンを再バインドできます。

単に () を使用すると、その空ストリングによって識別されるパッケージのバージョンが再バインドされます。

version-id を省略した場合、デフォルトは package-id を指定した方法によって異なります。package-id に * を使用すると、version-id のデフォルトも * となります。package-id に明示的に値を指定した場合、version-id のデフォルトは空ストリングのバージョンになります。

バージョン 2 リリース 3 より前の DB2 で作成された DBRM では、空ストリングの version-id をデフォルトとして使用します。

(*) (REBIND の場合のみ)適用可能な許可 ID が BIND 特権を有しているすべてのローカル DB2 パッケージを再バインドします。(*) を指定するのは、パッケージ名を (*.*.(*)) または(*.*) として指定したのと同じです。適用可能な許可 ID は以下のとおりです。

v オプション OWNER を使用する場合には、OWNER の値

v オプション OWNER を使用しない場合には、バインドを実行する処理の 1

次許可 ID

カタログ・レコード: 表 SYSPACKAGE の列 COLLID、NAME、およびVERSION。


v SYSIBM.LOCATIONS にロケーション名を定義する方法については、「DB2 管理ガイド」第 3 部を参照してください。

v REBIND PACKAGE コマンドでのコレクション、パッケージ、およびバージョンの指定に応じて、どのパッケージをバインドするかについては、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 4 部を参照してください。

PATH (schema-name)

(USER)

(schema-name,USER, ...)




修飾されていないユーザー定義の特殊タイプ、関数、およびストアード・プロシージャー名 (CALL ステートメント内) を解決するために DB2 が使用する SQL パスを決めます。

PATH オプションでは、 schema-name の指定にあたって次の指針を考慮してください。

v 指定されたスキーマ名は、DB2 により大文字に変換されません。この振る舞いは、SQL ステートメント内のスキーマ名 (カタログに保管される前に大文字に変換される) の振る舞いとは異なります。これらの区切られていないスキーマ名を大文字で指定しない場合、DB2 はこれらのスキーマ名と一致するものをカタログ内で見付けることができません。

v 区切り ID は、大文字小文字の混合した文字と大文字の両方とも指定することができます。

PATH キーワードは、PATHDEFAULT キーワードと両立できません。この両方のキーワードを同じ REBIND コマンドに指定しないでください。

(schema-name)スキーマを識別します。

指定されたスキーマが実際に存在するかどうかを、プリコンパイル時またはバインド時に DB2 は検査しません。

SYSIBM、SYSFUN、および SYSPROC スキーマについては明示的に指定する必要はありません。DB2 は、これらのスキーマが SQL パスの先頭にあることを暗黙に想定しています。DB2 はこれらのスキーマを前述のリスト順で追加します。SYSIBM、SYSFUN、および SYSPROC スキーマを指定しないと、これらは 2048 バイトの長さには含まれません。

(schema-name, ...)スキーマのリストを指定します。同じスキーマ名が、SQL パス内に複数回現れてはなりません。

指定できるスキーマの数は、結果となる SQL パスの長さ (2048 バイト以下) により制限されます。結果の SQL パスの長さは次のように計算します。

1. 各スキーマの長さを見る。

2. リスト内の各 schema-name を囲む区切り文字として 2 を加算する。

3. スキーマの後のコンマごとに 1 を加算する。最後のスキーマには 1 を加算しないでください。

USER 最大 8 バイトの schema-name を表します。バインド時に、DB2 はこの 8

バイトの長さを、PATH バインド・オプション用に指定されたスキーマ名のリストの合計長に含めます。スキーマ名のリストの最大長は、コンマ分離文字、区切り文字、および 8 バイトの USER 値を含めて、2048 バイトです。この制限を超えると、DB2 はバインド時にエラー・メッセージを出します。

実行時に、DB2 は PATH schema-name リスト内の USER の位置にあるschema-name のかわりに、USER 特殊レジスターの実行時の値を使用します。この特殊レジスターには、ランタイム処理の 1 次許可 ID が含まれます。



|

|

|

スキーマ名のリストに USER を指定する場合、USER キーワードを区切り文字で囲まないでください。

スキーマ名、通常 ID、および区切り ID について詳しくは、「DB2 SQL 解説書」第 2 章を参照してください。

デフォルト:


BIND PLAN 「SYSIBM」、「SYSFUN」、「SYSPROC」、プラン修飾子

BIND PACKAGE 「SYSIBM」、「SYSFUN」、「SYSPROC」、パッケージ修飾子



プラン修飾子は BIND PLAN のデフォルト値ですが、カタログには保管されません。その代わり、そのカタログ値はブランクです。このカタログ値は、パッケージ修飾子の場合もブランクです。

PATHDEFAULT 指定先: REBIND PLAN およびPACKAGE

パッケージまたはプラン用の PATH を「SYSIBM」、「SYSFUN」、「SYSPROC」、またはプラン修飾子 / パッケージ修飾子にリセットします。

PATHDEFAULT キーワードと PATH キーワードを同時に使用することはできません。この両方のキーワードを同じ REBIND コマンドに指定しないでください。

デフォルト:




REBIND PLAN なし

REBIND PACKAGE なし

PKLIST

NOPKLIST

(location-name.collection-id.package-id, ...) PKLIST のみ指定先: BIND と REBIND

PLAN

PKLIST は、プランのパッケージ・リストにどのパッケージを組み込むかを決定します。部分的な ID でパッケージを指定した順序によって実行時における検索順序が識別されますが、これがパフォーマンスに影響を与えることがあります。

NOPKLIST は、REBIND PLAN にだけ使用されます。NOPKLIST を指定すると、プランはパッケージ・リストを使用せずに再バインドされます。パッケージ・リストがすでに存在している場合は、NOPKLIST を指定するとそのリストは削除されます。



location-name または *パッケージが置かれる DBMS のロケーションを指定するか、実行時までその選択を据え置きます。特定のロケーション名またはアスタリスク (*) のいずれかを使用するか、 ID のこの部分を省略します。デフォルトは、ローカル DBMS

です。

v 特定のロケーション名を使用する場合には、その DBMS がカタログ表SYSIBM.LOCATIONS で定義されていなければなりません。この表が存在しないか、DBMS がその中にない場合は、警告メッセージが出されます。

v アスタリスクを使用すると、実行時にロケーション名が特殊レジスターCURRENT SERVER から使われます。DB2 は、そのロケーションのパッケージ内にある SQL ステートメントを使用する特権を検査します。

collection-id または *パッケージが含まれているコレクションを指定するか、実行時までこの選択を据え置きます。特定のコレクション ID またはアスタリスク (*) のいずれかを使用します。デフォルトはありません。

アスタリスクを使用すると、DB2 は、そのパッケージに組み込まれている SQL

ステートメントを使用する特権を実行時に検査します。さらにこの時点で、DB2

はコレクション ID を次のように判別します。

v 特殊レジスター CURRENT PACKAGESET 内の値がブランクでなければ、その値がコレクション ID になります。

v CURRENT PACKAGESET の値がブランクであれば、DB2 はこの項目がパッケージ・リストの最後の項目でなければこれをスキップします。それが最後または唯一の項目の場合は、エラー・メッセージが出されます。

package-id または *特定のパッケージを指定するか、あるいはコレクション内のすべてのパッケージをアスタリスクで指定します。パッケージ・リストに含まれるパッケージのversion-id は指定できないため、結果としてすべてのバージョンが含まれることになります。

デフォルト:


BIND PLAN なし




PKLIST にはデフォルトがありません。PKLIST を使用しない場合には MEMBER

を使用する必要があります。

NOPKLIST のデフォルトは、現在または直前のバインドまたは再バインド時にPKLIST オプションに指定したパッケージ・リスト (存在する場合) を使用することです。

カタログ・レコード: 表 SYSPACKLIST。




v パッケージの検索順序がパフォーマンスにどのように影響するかについては、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。

v SYSIBM.LOCATIONS にロケーション名を定義する方法については、「DB2 管理ガイド」第 3 部を参照してください。

v PKLIST に指定されたパッケージの最大数を制限する TSO/E の制約事項については、z/OS TSO/E プログラミング・サービスを参照してください。

PLAN (plan-name)

(*) (REBIND PLAN のみ)


バインドまたは再バインドするプラン (1 つ以上) を判別します。

(plan-name)アプリケーション・プランの名前を指定します。

REBIND の場合に限り、カタログ表 SYSPLAN の列 NAME となります。プラン名のリストを使用することも可能です。

デフォルトは、エラー診断を含むすべてのバインド機能を実行することです。ただし、アプリケーション・プランは作成されず、またオプション EXPLAIN のPLAN_TABLE に行が挿入されることもありません。

(*) (REBIND の場合のみ)適用可能な許可 ID が BIND 特権を有するすべてのプランを再バインドします。適用可能な ID は以下のとおりです。

v オプション OWNER を使用する場合には、OWNER の値

v オプション OWNER を使用しない場合には、バインドを実行する処理の許可ID

カタログ・レコード: 表 SYSPLAN の列 NAME。

QUALIFIER (qualifier-name) 指定先: BIND と REBIND のPLAN と PACKAGE

プランやパッケージに含まれる未修飾名の表、ビュー、索引、および別名における、暗黙の修飾子を判別します。

(qualifier-name)暗黙の修飾子の値を指定します。この値は、BIND または REBIND PACKAGE

のためにリモート・システムに送られる際の変換の対象にはなりません。

デフォルト:


BIND PLAN 所有者 ID

BIND PACKAGE 所有者 ID





デフォルトは、その所有者の許可 ID です。OWNER オプションやそのデフォルトを使用する場合も同様です。

カタログ・レコード: 表 SYSPACKAGE および SYSPLAN の列 QUALIFIER。

RELEASE (COMMIT)

(DEALLOCATE)


TRIGGER PACKAGE

プログラムが使用するリソースをいつ解放するかを判別します。各コミット・ポイント、あるいはプログラムの終了時のいずれかです。

(COMMIT)各コミット・ポイントでリソースを解放します。

(DEALLOCATE)プログラムの終了時にのみリソースを解放します。

RELEASE(DEALLOCATE) は、クライアント・システムとの DRDA 接続を通して DB2 サーバー上で実行されるパッケージには影響を与えません。この値は動的 SQL ステートメント (常に RELEASE(COMMIT) を使用する) にも影響を与えませんが、1 つだけ例外があります。それは、RELEASE(DEALLOCATE) および KEEPDYNAMIC(YES) を使用する場合で、インストール・パネルDSNTIP4 のフィールド CACHE DYNAMIC SQL に YES を指定してサブシステムをインストールする場合、動的 SELECT、INSERT、UPDATE、およびDELETE ステートメントに対して RELEASE(DEALLOCATE) オプションが有効になります。

動的ステートメントについて獲得されるロックは、以下のいずれかのイベントが発生するまで保留されます。

v アプリケーション処理が終了する (deallocation)。

v アプリケーションが、同じステートメント ID を指定した PREPARE ステートメントを出す。(ロックは次のコミット・ポイントで解放される)

v ステートメントが使用されなかったため、キャッシュから削除される。(ロックは次のコミット・ポイントで解放される)

v ステートメントが依存しているオブジェクトが除去、または変更される。または、ステートメントが必要とする特権が取り消される。(ロックは次のコミット・ポイントで解放される)

RELEASE(DEALLOCATE) は、パッケージまたはプラン内に追加の項目が常駐することになるので、パッケージまたはプランのサイズが大きくなる可能性があります。

RELEASE オプションがロックと並行性にどのような影響を与えるかについて詳しくは、「DB2 管理ガイド」第 5 部 (第 2 巻) または「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。

デフォルト:


BIND PLAN COMMIT






COMMIT は、リモート・サーバーでバインドされるパッケージのデフォルトです。

カタログ・レコード: 表 SYSPACKAGE および SYSPLAN の列 RELEASE。

REOPT (NONE)

(ALWAYS)

(ONCE)

指定先: BIND と REBIND の PLAN とPACKAGE

ホスト変数、パラメーター・マーカー、および特殊レジスターの値を使用して実行時に DB2 にアクセス・パスを決定させるかどうかを指定します。(NONE)

実行時にアクセス・パスを決定しません。NOREOPT(VARS) をREOPT(NONE) の同義語として使用することができます。

(ALWAYS)ステートメントを実行するつど、実行時にアクセス・パスを再決定します。REOPT(VARS) を REOPT(ALWAYS) の同義語として使用できます。

(ONCE)最初の実行時またはそのステートメントを最初に開く時点で、どの動的ステートメントに対するアクセス・パスも 1 回だけ決定します。このアクセス・パスは、準備済みのステートメントが無効化されるまで、または動的ステートメント・キャッシュから除去されて再度準備する必要が生じるまで、使用されます。

使用上の注意:

以下のオプション付き REOPT(ALWAYS) を使用することはできません。

v REOPT(NONE)

v REOPT(ONCE)

v KEEPDYNAMIC(YES)

REOPT(ONCE) には以下の制約があります。

v REOPT(ONCE) は DB2 バージョン 8 新機能モード以降でのみ使用可能です。REOPT(ONCE) は、プランまたはパッケージにバージョン 8 依存のマークを付けます。

v REOPT(ONCE) は、静的 SQL ステートメントで使用する場合、無視されます。それは、DB2 UDB for z/OS が動的ステートメントしかキャッシュに入れないからです。

v 動的ステートメント・キャッシングがオフのときに、REOPT(ONCE) 指定でバインドされたプランまたはパッケージ内の動的ステートメントを実行すると、このステートメントは、REOPT(ONCE) が無指定の場合と同様に実行されます。

v REOPT(ONCE) と NODEFER(PREPARE) の両方を同時には使用できません。

v REOPT(ONCE) と KEEPDYNAMIC(YES) の両方を同時には使用できません。



デフォルト:


BIND PLAN NONE

BIND PACKAGE NONE



REOPT(NONE) は、リモート DB2 サーバーでバインドされるパッケージのデフォルトです。

カタログ・レコード: 表 SYSPLAN および SYSPACKAGE の列 REOPTVAR。

SQLERROR (NOPACKAGE)

(CONTINUE)

指定先: BIND PACKAGE のみ

SQL エラーが生じたときにパッケージを作成するかどうかを判別します。

(NOPACKAGE)エラーが生じたらパッケージを作成しません。

(CONTINUE)SQL ステートメントのバインド時にエラーが生じても、パッケージを作成します。エラーのあるステートメントは実行できません。実行時にそれらを実行しようとしても、エラーが生じるだけです。

デフォルト:



BIND PACKAGE NOPACKAGE



REBIND PACKAGE でオプション SQLERROR は使用できないため、以前のパッケージの値はそのパッケージの再バインドの際には有効なままです。SQLERROR(CONTINUE) を使用するパッケージを再バインドすると、バインド時にエラー状態で見つかった SQL ステートメントは再バインドされません。

カタログ・レコード: 表 SYSPACKAGE の列 SQLERROR。

SQLRULES (DB2)

(STD)


既存の SQL 接続に対して、タイプ 2 CONNECT ステートメントを DB2 の規則に従って実行できるか判別します。これ以外の場合、このステートメントは 1992 年の ANSI/ISO SQL 標準によりエラーを引き起こします。このオプションは、このプランを使用し、タイプ 2 CONNECT ステートメントを実行するすべてのアプリケ



ーション処理に適用されます。このオプションは、タイプ 1 CONNECT ステートメントまたは DB2 プライベート・プロトコル・アクセスの規則には影響を与えません。

(DB2) CONNECT が既存の SQL 接続を識別してもエラーにはなりません。X が既存の SQL 接続である場合、CONNECT TO X は X を現行接続にします。X がすでに現行接続であれば、CONNECT TO X は接続の状態に何の影響も与えません。

(STD) CONNECT が既存の SQL 接続を識別するとエラーが生じます。したがって、X が休止 SQL 接続である場合は、SQL ステートメント SET

CONNECTION を用いて X を現行接続にしなければなりません。

ローカル操作の場合には、SQL 特殊レジスター CURRENT RULES の初期値としてSQLRULES の値が使用されます。

デフォルト:


BIND PLAN DB2




カタログ・レコード: 表 SYSPLAN の列 SQLRULES。

VALIDATE (RUN)

(BIND)


バインドまたは再バインド時に検出されたタイプ "OBJECT NOT FOUND" および"NOT AUTHORIZED" のエラーを実行時に再検査するかどうかを決定します。すべてのオブジェクトと必要な特権が存在していれば、このオプションは何の影響も与えません。

(RUN) バインド時にオブジェクトまたは特権の一部が存在しない場合、処理では警告メッセージを出しますが、バインドは続行されることを示します。DB2

は実行時に、バインドの間に検査が失敗した SQL ステートメントについて再びその存在と許可を検査します。検査においては、そのプランまたはパッケージ所有者の許可 ID が使用されます。

(BIND)バインド時に一部のオブジェクトまたは必要な特権が存在しない場合、処理ではエラー・メッセージを出し、プランやパッケージのバインドまたは再バインドを行わないことを示します。ただし、次の場合は例外です。

BIND PACKAGE の場合に限り、オプション SQLERROR(CONTINUE)

を使用していればバインドは続行されますが、エラーのある SQL ステートメントは実行できません。



デフォルト:


BIND PLAN RUN

BIND PACKAGE RUN



カタログ・レコード: 表 SYSPACKAGE および SYSPLAN の列 VALIDATE。



第 16 章 -CANCEL THREAD (DB2)

DB2 コマンド CANCEL THREAD を使用すると、特定のローカル・スレッドまたは分散スレッドの処理が取り消されます。

省略形: -CAN THD


v 『環境』

v 『許可』

v 『構文』








構文

�� CANCEL THREAD(token)DDF THREAD( luwid )

tokenDUMP NOBACKOUT

��


オプションの説明THREAD (token)処理を取り消したい特定のスレッド (分散でもそれ以外でも) を識別します。DB2 はそれぞれのスレッドにトークンを割り当てます。割り当てられるトークンは、その DB2 サブシステムにおいては固有のものですが、サブシステム間においても固有であるとは限りません。

トークンは 1 ～ 6 桁の 10 進数です。トークンが何であるかを判別するには、DB2 コマンド DISPLAY THREAD を出すか、IFCID 0147 または 0148 に対して IFI READS 呼び出しを使用します。トークンはさらに、LUWID を表示するDB2 メッセージの等号の後ろにも表示されることがあります。

DDF THREAD(luwid)処理を取り消したい分散スレッドを指定します。luwid は、作業論理単位 ID

(LUWID) で、以下の要素で構成されています。

v 完全修飾 LU ネットワーク名。以下の要素からなります。– 1 ～ 8 文字のネットワーク ID

– ピリオド– 1 ～ 8 文字のネットワーク LU 名

v LUW インスタンス番号。その作業単位を固有に識別する 12 個の 16 進数文字からなります。

ピリオドで区切った 3 つのフィールドを入力した場合、DB2 は LUWID が入力されたものと見なします。

同じ LUWID に 2 つ以上の分散スレッドを指定することもできます。この場合、その同じ LUWID に指定されたすべての分散スレッドが取り消されます。

LUWID は DB2 DISPLAY THREAD コマンドや他の DB2 メッセージから判別することもできます。

DUMP診断のためのダンプを提供します。

現在 DB2 でアクティブになっていないスレッドを取り消すと、DB2 はハード取り消しを実行し、ダンプは取られません。あるスレッドが DB2 にアプリケーション作業の実行を任せてしまうと、そのスレッドは、その時点で DB2 ではアクティブになっていないと見なされます。

NOBACKOUTDB2 がトランザクションのロールバック処理中にデータのバックアウトを試みないことを指定します。NOBACKOUT オプションを指定してスレッドを取り消すと、オブジェクトは不整合状態のままとなります。データの不整合解決も予定内であるという場合以外、NOBACKOUT オプションを指定してこのコマンドを発行しないでください。

NOBACKOUT 要求は複数発行することが可能です。しかし、スレッドがアクティブで、要求が受け入れられた場合、後続の要求は無視されます。要求が失敗した場合のみ、後続の要求を発行することを選択できます。スレッドが変更するオブジェクトは、リカバリー (バックアウト) されます。バックアウト処理が失敗した場合、そのオブジェクトは REFRESH PENDING (REFP) とマークされます。また、データベース例外表では RECOVER PENDING (RECP) または

-CANCEL THREAD (DB2)


REBUILD PENDING (RBDP または PSRBD) とマークされます。このオブジェクトの REFP 状況を解決するには、RECOVER ユーティリティーを実行してオブジェクトを以前の時点の状況にリカバリーするか、または LOAD REPLACE

をそのオブジェクトに対して実行します。

使用上の注意分散スレッドの取り消し: 分散スレッドを取り消すと、スレッドが未確定状態になることがあります。 CANCEL コマンドが原因で DDF スレッドがアクティブ状態から未確定状態に変わってしまった場合には、メッセージ DSNL450I が出されます。コーディネーターの自動的な未確定解決を行う機能により、またはコマンドRECOVER INDOUBT を用いることにより、未確定状態が解消すると DB2 はそのスレッドが保持しているリソースを解放します。

コマンドで指定されたスレッドがグローバル・トランザクションの一部である場合、コマンドはグローバル・トランザクション内のすべてのスレッドに対して実行されます。グローバル・トランザクションの説明については、「DB2 管理ガイド」の第 5 章を参照してください。

CANCEL コマンドは、スレッドが DB2 内で終了するようにスケジュールします。終了させるためには、スレッドが DB2 内で処理を実行中でなければなりません。スレッドが終了しない場合、以下のような原因が考えられます。

v 処理が DB2 の外で、おそらくはアプリケーション内で行われていた。この場合、そのアプリケーションが DB2 に要求を行うまでスレッドは終了しません。z/OS CANCEL コマンドを使用して、そのアプリケーションをすぐに終了させてください。

v ネットワーク操作がハングアップした。VTAM または TCP/IP コマンドを使用して、ネットワーク操作が処理を DB2 に戻すようにしてください。これにより、スレッドを終了できるようになります。詳細については、以下のトピックを参照してください。

ローカル・スレッドの取り消し: CANCEL コマンドはスレッドが終了するようスケジュールします。DB2 内にないスレッドは即時に終了します。

VTAM コマンドによる SNA 分散スレッドの取り消し: CANCEL コマンドで分散スレッドが終了しない場合には、 VTAM でハングアップしたことが考えられます。このような時には、VTAM VARY NET,TERM コマンドを使用してそのスレッドのVTAM セッションを取り消してください。これを行うには、そのスレッドに対応する VTAM セッション ID (SID) を知っている必要があります。以下のステップに従ってください。

1. DB2 コマンド DISPLAY THREAD(*) LUWID(nnnn) DETAIL を出す。(nnnn の値は、 CANCEL DDF THREAD により提供されるトークンまたは LUWID です。)

この結果、取り消さなければならない VTAM セッションの ID が得られます。以下の DISPLAY THREAD 出力結果に示されているように、セッションは列ヘッダー SESSID によって識別されます。

-DIS THD(*) LUWID(123) DETAIL


第 16 章 -CANCEL THREAD (DB2) 109

DSNV401I - DISPLAY THREAD REPORT FOLLOWS:DSNV402I - ACTIVE THREADS:NAME ST A REQ ID AUTHID PLAN ASID TOKENBATCH TR * 5 BKH2C SYSADM BKH2 000D 123V444-DB2NET.LUND0.9F6D9F459E92=123 ACCESSING DATA ATV446-SAN JOSE:LUND1V447--LOCATION SESSID A ST TIMEV448--SAN JOSE 00D3590EA1E89701 S1 9332108460302V448--SAN JOSE 00D3590EA1E89822 V R1 9332108460431DISPLAY ACTIVE REPORT COMPLETEDSN9022I - DSNVDT ’-DIS THD’ NORMAL COMPLETION

V は、スレッドが VTAM 内で処理中であることを示しています。

2. 取り消すスレッドの SESSID の、位置 3 から 16 を記録する。(上記のDISPLAY THREAD 出力結果では、値 D3590EA1E89701 と D3590EA1E89822

を記録することになります。)

3. VTAM コマンド DISPLAY NET を出して、 VTAM セッション ID を表示する。取り消したいスレッドは SESSID の位置 3 ～ 16 が一致しているもので、その対応するセッション ID は太字で示されています。以下はこのコマンドの出力例です。

4. VTAM コマンド VARY NET,TERM を DB2 スレッドに関連した VTAM SID

ごとに出す。この例では、DISPLAY THREAD が VTAM 内(D2D3590EA1E89822) で処理中であるとして表示するセッション ID だけを取り消す必要があると考えられます。

VTAM コマンドについて詳しくは、「VTAM 操作解説書 (MVS/ESA 版)」を参照してください。

TCP/IP コマンドによる TCP/IP 分散スレッドの取り消し: CANCEL コマンドで分散スレッドが終了しない場合には、TCP/IP でハングアップしたことが考えられます。TCP/IP DROP コマンドを使用して、スレッドの接続 ID を取り消します。これを行うには、そのスレッドに対応する TCP/IP 接続 ID を最初に決めておく必要があります。スレッドが DB2 リクエスターであるかサーバー・スレッドであるかに応じて、次のステップを行ってください。

v リクエスター・スレッドのための TCP/IP 接続の終了:

1. DB2 コマンド DISPLAY THREAD(*) LUWID(nnnn) DETAIL を出す。(nnnn

の値は、 CANCEL THREAD により提供されるトークンまたは LUWID です。)

以下の DISPLAY THREAD 出力で示すような方式で、パートナーへの接続のための IP アドレスとローカル・ポートを検索する。

D NET,ID=LUND0,SCOPE=ACT

IST097I DISPLAY ACCEPTEDIST075I NAME = LUND0, TYPE = APPL

IST486I STATUS= ACTIV, DESIRED STATE= ACTIVIST171I ACTIVE SESSIONS = 0000000005, SESSION REQUESTS = 0000000000IST206I SESSIONS:IST634I NAME STATUS SID SEND RECV VR TP NETIDIST635I LUND1 ACTIV-S D24B171032B76E65 0051 0043 0 0 NET2IST635I LUND1 ACTIV-S D24B171032B32545 0051 0043 0 0 NET2IST635I LUND1 ACTIV-R D2D3590EA1E89701 0022 0031 0 0 NET2IST635I LUND1 ACTIV-R D2D3590EA1E89802 0022 0031 0 0 NET2IST635I LUND1 ACTIV-R D2D3590EA1E89822 0022 0031 0 0 NET2IST314I END



#display thread(*) detail

DSNV401I # DISPLAY THREAD REPORT FOLLOWS -DSNV402I # ACTIVE THREADS -NAME ST A REQ ID AUTHID PLAN ASID TOKENTEST0001 TR 4 CTHDCORID001 SYSADM DONSQL1 0027 19V444-USIBMSY.SYEC715B.B4FA989AF056=19 ACCESSING DATA ATV446-STL714A:9.112.114.102:446V447--LOCATION SESSID A ST TIMEV448--STL714A 1028:446 V R2 0032608521413DISPLAY ACTIVE REPORT COMPLETEDSN9022I # DSNVDT ’-DIS THD’ NORMAL COMPLETION

この場合は、パートナーの IP アドレスとポートは、9.112.114.102 446 で、ローカル・ポートは 1028 です。V は、スレッドが TCP/IP で処理中であることを示しています。

2. 関連する TCP/IP 接続 ID を次のように決定する。

d tcpip,,netstat,conn,ipaddr=9.112.114.102

EZZ2500I NETSTAT CS V2R10 TCPIPUSER ID CONN LOCAL SOCKET FOREIGN SOCKET STATEV71BDIST 0000049D 9.112.114.103..1028 9.112.114.102..446 ESTBLSH1 OF 1 RECORDS DISPLAYED

3. 次のようにして、接続を終了する。

v tcpip,,drop,conn=0000049d

EZZ0060I PROCESSING COMMAND: VARY TCPIP,,DROP,CONN=0000049DEZZ0053I COMMAND VARY DROP COMPLETED SUCCESSFULLY

v サーバー・スレッドのための TCP/IP 接続の終了:

1. DB2 コマンド DISPLAY THREAD(*) LUWID(nnnn) DETAIL を出す。(nnnn

の値は、 CANCEL THREAD により提供されるトークンまたは LUWID です。)

以下の DISPLAY THREAD 出力で示すような方式で、パートナーへの接続のための IP アドレスとローカル・ポートを検索する。

!display thread(*) detail

DSNV401I ! DISPLAY THREAD REPORT FOLLOWS -DSNV402I ! ACTIVE THREADS -NAME ST A REQ ID AUTHID PLAN ASID TOKENTEST0001 RA * 2 CTHDCORID001 SYSADM DONSQL1 002D 11V445-USIBMSY.SYEC715B.B4FA9BB94FA7=11 ACCESSING DATA FOR

9.112.114.103V447--LOCATION SESSID A ST TIMEV448--9.112.114.103 446:1029 W R2 0032609061159DISPLAY ACTIVE REPORT COMPLETEDSN9022I ! DSNVDT ’-DIS THD’ NORMAL COMPLETION

この場合は、パートナーの IP アドレスは、9.112.114.103 で、ローカル・ポートは 1029 です。

2. 関連する TCP/IP 接続 ID を次のように決定する。

d tcpip,,netstat,conn,ipaddr=9.112.114.103

EZZ2500I NETSTAT CS V2R8 TCPIPUSER ID CONN LOCAL SOCKET FOREIGN SOCKET STATEV61ADIST 0000048E 9.112.114.102..446 9.112.114.103..1029 ESTABLS1 OF 1 RECORDS DISPLAYED


第 16 章 -CANCEL THREAD (DB2) 111

外部ソケット (FOREIGN SOCKET) がパートナーの IP アドレスとポート(9.112.114.103 1029) を示している項目を検索し、CONN を書き留める。

3. 次のようにして、接続を終了する。

v tcpip,,drop,conn=0000048e

EZZ0060I PROCESSING COMMAND: VARY TCPIP,,DROP,CONN=0000048EEZZ0053I COMMAND VARY DROP COMPLETED SUCCESSFULLY

例例 1: DISPLAY THREAD コマンドを使用して検出したトークンを持つ非分散スレッドを取り消し、診断ダンプを作成するには、以下のコマンドを出します。

-CANCEL THREAD (123) DUMP

例 2: DISPLAY THREAD コマンドを使用して検出した LUWID を持つ分散スレッドを取り消すには、以下のコマンドを出します。

-CANCEL DDF THREAD (LUDALLAS.DB2SQL1.3042512B6425)

-DISPLAY THREAD からの出力結果が、この LUWID に関連したスレッド ID とトークンが 45162 であったことを示しているものとします。このスレッドは、さらに以下のいずれかのコマンドを出して取り消すことが可能です。

-CANCEL DDF THREAD (45162)

-CANCEL THREAD (45162)

最初の例にあるように、この例で示された任意のコマンドに DUMP を指定すると、診断用のダンプが作成されます。



第 17 章 /CHANGE (IMS)

IMS コマンド /CHANGE は、/DISPLAY コマンドの OASN キーワードによって識別された未確定のリカバリー単位をリセットするときに使用します。このコマンドは、IMS の立場から項目を削除しますが、DB2 とは通信しません。

省略形: /CHA


v 『環境』

v 『許可』

v 『構文』

v 『オプションの説明』



環境このコマンドは、IMS 端末からのみ発行できます。


許可このコマンドには適切なレベルの IMS 権限が必要であり、これについては「IMS

管理の手引き: システム」で説明しています。

構文

�� /CHANGE �

,

SUBSYS subsystem-namesubsystem-name OASN schedule-numberALL

RESET ��

オプションの説明SUBSYS

1 つ以上のサブシステムから IMS リカバリー・エレメントを削除します。以下のいずれかのサブパラメーターをコーディングする必要があります。


subsystem-name

1 つ以上のサブシステムをコンマで区切って指定します。そのサブシステムからリカバリー・エレメントが削除されることになります。

subsystem-name OASN schedule-number

subsystem-name で指定された 1 つのサブシステムから、コンマで区切られた 1 つ以上の起点アプリケーションのスケジュール番号を削除します。

schedule-number には、最大 32768 までの起点アプリケーション・スケジュール番号をリストすることができます。番号の表示には、/DISPLAY コマンドの OASN パラメーターを使用します。

ALLすべてのサブシステムから IMS リカバリー・エレメントを削除します。

RESET未確定リカバリー単位を削除します。リカバリー単位とは、アプリケーションの要求の結果として外部サブシステムに割り当てられた未完了の作業単位を意味します。

使用上の注意/CHANGE コマンドについての前述の説明は部分的なものです。詳しくは、「IMS

コマンド解説書」を参照してください。

例例 1: サブシステム DB2 の未確定リカバリー単位をすべてリセットします。

/CHA SUBSYS DB2 RESET

例 2: 全サブシステムの未確定リカバリー単位をすべてリセットします。

/CHA SUBSYS ALL RESET

例 3: サブシステム DB2 の OASN 番号 99、685、および 2920 によって識別される未確定リカバリー単位をリセットします。

/CHA SUBSYS DB2 OASN 99 685 2920 RESET

/CHANGE (IMS)


第 18 章 DCLGEN (DECLARATIONS GENERATOR) (DSN)

宣言生成機能 (DCLGEN) は、SQL DECLARE TABLE ステートメント、およびCOBOL、PL/I、C などのカタログで指名される表またはビューに対するデータ宣言を作成します。

DCLGEN コマンドとその出力結果の使用について詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 2 部を参照してください。


v 『環境』

v 『許可』





環境宣言生成機能は、DSN サブコマンド DCLGEN により実行されます。このサブコマンドは、フォアグラウンドまたはバックグラウンドのいずれかのモードで実行するDSN セッションから出すか、または DB2I を介して出すことができます。


許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v 表またはビューの所有権v 表またはビューの SELECT 特権v 表が入っているデータベースの DBADM 権限v SYSADM 権限v SYSCTRL 権限 (カタログ表のみ)


構文

�� DCLGEN TABLE( table-name )view-name OWNER(owner-name)

�

�AT(location-name)

�

� LIBRARY(library name )(member-name) /password

�

�ADD

ACTION( REPLACE )COBOL

LANGUAGE( PLI )CCOB2IBMCOBCPP

NAMES(prefix)�

�STRUCTURE(structure-name) APOST

QUOTENO

LABEL YES

�

�DBCSSYMBOL( G )

NYES

DBCSDELIM( NO )

�

�NO

COLSUFFIX( YES )NO

INDVAR( YES )STD

RMARGIN( WIDE )

��

オプションの説明TABLE宣言が生成される対象となる表またはビューを指定します。table-name またはview-name は、表またはビューの修飾名または非修飾名です。

名前は、次の規則に従わなければなりません。

v 名前が単一バイトまたは混合ストリングで、かつ下線 (_) 以外の特殊文字を含む場合は、それをアポストロフィ (') で囲む必要があります。言語がCOBOL の場合には、名前の中の単一バイトの下線は DCLGEN によってハイフン (-) に変換されます。2 バイト文字セット (DBCS) の名前はアポストロフィで囲む必要はありません。

v 名前に単一バイトのアポストロフィが含まれる場合は、それぞれを二重 ('')

にしておく必要があります。(ホスト言語によっては、変数名にアポストロフィを使えないことがあります。)

アポストロフィで囲んでいない、ピリオドを含んだ表またはビュー名は、修飾表名です。ピリオドの左側の文字は表所有者となり、ピリオドの右側の文字が表名となります。アポストロフィで囲まれた表名はすべて非修飾表名です。DCLGEN による表名修飾子の判別の仕方については、続く OWNER パラメーターの項の説明を参照してください。

DCLGEN (DSN)


OWNER(owner-name)表名の修飾子を指定します。owner-name は表名の修飾子です。

TABLE(table-name) オプションに修飾表名を指定し、かつ OWNER(owner-name)

も指定すると、table-name の修飾子部分が owner-name に置き換わって表名修飾子になります。TABLE(table-name) オプションに非修飾表名を指定し、OWNER(owner-name) を指定しない場合は、SQL 許可 ID が表名修飾子になります。

DCLGEN では、owner-name キーワード・パラメーターに下線 (_) を有効な文字として使用できます。

表 15 は、DCLGEN 表名修飾子を決める決定プロセスを説明しています。

表 15. DECLGEN 表名修飾子を決める決定プロセス。

表名 OWNER(owner-name) を指定OWNER(owner-name) を指定せず

修飾されたTABLE(table-name)

table-name 修飾子 table-name 修飾子

修飾されないTABLE(table-name)

owner-name SQL 許可 ID

AT(location-name)TABLE (table-name) に指定された表名またはビュー名のロケーションを識別します。location-name は 1 ～ 16 文字からなるもので、ネットワークにおける表またはビューのインスタンスを固有に識別します。

AT を指定した場合、location-name は表名の接頭部として使用され、table-name

または table-view を修飾名にする必要があります。

DCLGEN では、location-name キーワード・パラメーターに下線 (_) を有効な文字として使用できます。

LIBRARY(library-name(member-name)/password)宣言を入れるデータ・セットを指定します。このデータ・セットはすでに存在していて、宣言生成機能からアクセス可能でなければなりません。このオプションには、順次データ・セットまたは区分データ・セットのいずれかを指定できます。password はオプションです。

ライブラリー名がアポストロフィで囲まれていない場合には、 DCLGEN によって以下のような完全データ・セット名が構成されます。

user-prefix.library-name.language.(member-name)

意味は次のとおりです。

user-prefix トランザクションの 1 次許可 ID のユーザー接頭部。

language LANGUAGE オプションの値で、COBOL、COB2、PLI、または C を指定します。

(member-name) オプション。使用しない場合、出力は順次データ・セットに入れられます。

DCLGEN (DSN)

第 18 章 DCLGEN (DECLARATIONS GENERATOR) (DSN) 117

ACTIONデータ・セットに追加するか、置き換えるかを示します。

(ADD)すでに存在するデータ・セットがない場合は、データ・セットを新規メンバーとして追加します。

デフォルトは ACTION(ADD) です。

(REPLACE)既存のメンバーまたはデータ・セットを、新しいメンバーまたはデータ・セットに置き換えます。出力先が区分データ・セットであり、かつ所定の名前のメンバーが存在しない場合は追加されます。

LANGUAGE生成される宣言の言語を指定します。

指定可能な言語は以下のとおりです。

v (COBOL)、OS/VS COBOL の場合

v (COB2)、他の COBOL 言語の場合

v (PLI)、PL/I の場合

v (C)、C/370™ の場合

v (IBMCOB)、IBM COBOL の場合

v (CPP)、C++ の場合

NAMES(prefix)フィールド名を宣言内に組み入れることができます。

DCLGEN 出力とソース・プログラムとの間で、名前の矛盾が生じないようにしてください。矛盾が生じた場合には、NAMES または STRUCTURE を使用するか、生成した宣言またはソース・プログラムを手操作で編集します。

prefix には 2 バイト文字を入れることができます。

フィールド名は、prefix を長さが 1 ～ 3 桁の番号に連結したもので構成されます。prefix には最大 28 文字を指定できます。prefix が 1 バイトまたは混合のストリングで、先頭文字が英字ではない場合は、それをアポストロフィで囲む必要があります。例えば、prefix が ABCDE であれば、フィールド名はABCDE1、ABCDE2、から ABCDE999 (最大) となります。特殊文字は使用できますが、名前の矛盾が生じないように注意してください。

COBOL および PL/I において、接頭部が DBCS ストリングの場合のフィールド名は、DBCS の接頭部を DBCS による数字に連結したものになります。例えば、接頭部が <D1D2D3> の場合 (「<」と「>」はそれぞれシフトアウト文字とシフトイン文字を表し、 D1D2D3 は 2 バイト文字を表すものとする)、生成されるフィールド名は <D1D2D3.1>、<D1D2D3.2>、などとなります。ピリオド(.) は X'42' を表します。

表の列名は、出力結果におけるフィールドのデフォルト名となります。

STRUCTURE(structure-name)生成されるデータ構造を指定します。

DCLGEN (DSN)


structure-name には最大 31 文字を指定できます。structure-name が 1 バイトまたは混合のストリングで、先頭文字が英字ではない場合は、それをアポストロフィで囲む必要があります。特殊文字は使用できますが、名前の矛盾が生じないように注意してください。

structure-name には 2 バイト文字を入れることができます。

SQL 出力の場合の名前は、表名またはビュー名と同じです。ホスト言語が C

である場合のデフォルトの構造名は、接頭部 DCL を表名に連結したものです。ホスト言語が COBOL または PL/I であり、表名が 1 バイトまたは混合のストリングである場合にもデフォルトの構造名は接頭部 DCL を表名に連結したものとなります。ホスト言語が COBOL または PL/I であり、表名が DBCS ストリングである場合には、デフォルトの構造名は接頭部 <.D.C.L> と表名またはビュー名とを連結させたものになります。「<」および「>」はそれぞれ、シフトアウト文字とシフトイン文字を表します。ソース・プログラムにある名前と同じになる可能性がありますのでご注意ください。指定された構造名が表またはビューの名前と同一であっても、DCLGEN を使用することは可能ですが、それによって警告メッセージが出されることになります。

APOST または QUOTEホスト言語で使用されるストリング区切り文字を指定します。このオプションはCOBOL プログラムにおいてのみ有効です。

APOST はアポストロフィ (') をホスト言語のストリング区切り文字として指定し、SQL 区切り文字は引用符 (") です。

QUOTE は引用符 (") をホスト言語の区切り文字として指定し、 SQL 区切り文字はアポストロフィ (') です。

APOST と QUOTE のいずれも指定しない場合、COBOL でのデフォルトは、DB2 のインストール・パネル DSNTIPF で指定した内容にもとづいて APOST

または QUOTE のいずれかになります。

ストリング区切り文字は、ホスト言語ステートメントにおいてストリングを区切る働きをします。また SQL エスケープ文字は、DCLGEN が作成した SQL

DECLARE TABLE ステートメントで表や列の名前を区切る働きをします。DB2

インストール時の選択によって、区切り文字を両方とも引用符かアポストロフィにすることも可能です。

LABEL列ラベルをコメントとして出力に組み込むかどうかを示します。(列ラベルは、LABEL ON ステートメントで割り当てることが可能です。)

NO 列ラベルを省略します。

YES 列ラベルを組み込みます。

DBCSSYMBOLCOBOL PICTURE 文節でグラフィック・データ・タイプを表すときに使用する記号を指定します。

(G) グラフィック・データを G により表します。

(N) グラフィック・データを N により表します。

DCLGEN (DSN)


DBCSDELIM生成された DECLARE 表ステートメントの DBCS 表名と列名に区切りを入れるかどうかを指定します。

(YES) DCLGEN 表宣言で、DBCS 表名と列名に区切りが入ります。

(NO) DCLGEN 表宣言で、DBCS 表名と列名には区切りが入りません。

COLSUFFIX列名を NAMES オプションによる接頭部につなげてフィールド名を形成するかどうかを判別します。

(NO)列名は接尾部としては使用されず、フィールド名は、オプション NAMES

によって制御されることになります。

(YES)NAMES が指定されていれば、DCLGEN は列名を接尾部として NAMES の値につなげることにより、フィールド名を形成します。例えば、NAMES による接頭部が「NEW」で列名が EMPNO だとすると、フィールド名は「NEWEMPNO」となります。

NAMES が指定されていない場合には、DCLGEN は警告メッセージを出し、列名をフィールド名として使用します。

INDVARホスト変数構造のための標識変数配列を作成するかどうかを判別します。

(NO)DCLGEN は標識変数配列を作成しません。

(YES)DCLGEN はホスト変数構造のための標識配列を作成します。配列名は、表名に接頭部「I」(または、表名が 2 バイト文字の場合は DBCS 文字「<I>」) を付けたものです。

RMARGINDCLGEN 出力の 1 つ以上の後続のレコードにラップされる必要のあるステートメント・トークンのブレークポイントを指定します。

(STD)ステートメント・トークンは、72 カラムより後がラップされます。

(WIDE)ステートメント・トークンは、80 カラムより後がラップされます。

使用上の注意DCLGEN コマンドの構文解析は、標準の TSO 構文解析規則に従っています。TSO

コマンドの構文解析については、「z/OS TSO/E プログラミング・サービス」を参照してください。

DECLARE ステートメント: DCLGEN が生成する DECLARE ステートメントは、データ・タイプが VARCHAR または LONG VARCHAR で作成されるすべての列

DCLGEN (DSN)


#

#

#

#

#

#

#

を VARCHAR として定義します。また、データ・タイプを VARGRAPHIC またはLONG VARGRAPHIC として作成される列は、VARGRAPHIC として定義されます。

コメント: ホスト言語の出力には、コメントが含まれています。先行するコメントのブロックには、宣言を要求した DCLGEN サブコマンドがその出されたとおりに反映されます。後続のコメント・ブロックには、宣言された変数の数が示されます。

出力の使用: DCLGEN の出力をアプリケーション・プログラムに組み込むためには、SQL INCLUDE ステートメントを使用してください。INCLUDE ステートメントには、 DCLGEN LIBRARY パラメーターに指定されたのと同じメンバー名が指定されます。

プロンプト: オプションが指定されていなかったりオプションの指定が正しくない場合は、オンライン TSO によってプロンプトが出されます。

出力の編集: DCLGEN の出力が要求をすべて満たしているとは期待できません。そこで、その出力結果はプログラムに組み込む前に自由に編集することができるようになっています。例えば、変数名を変更したり、SQL エスケープ文字を含めたい場合があるかもしれません。

出力を編集することで、ヌル値が許されない列の NOT NULL に WITH DEFAULT

を追加することが可能です。出力を編集したなら、デフォルト値を指定しておく必要があります。

列名に組み込みブランクが含まれていると、それはホスト変数宣言にも反映されるため、ブランク文字はいずれも除くか他の値に変換する必要があります。

C: C 言語では、以下のように独自の DCLGEN を行います。

v DCLGEN において STRUCTURE、NAMES、または TABLE の値は大文字に変換されません。

v データ・タイプが CHAR(n) である DB2 列があり、n > 1 となっている場合、DCLGEN はそれに対応するホスト変数を CHAR(n + 1) として生成し、DB2 による警告が発生しないようにします。n = 1 であれば、対応するホスト変数はCHAR となります。

COBOL と 2 進整数: DB2 ではフルサイズの 2 進整数を使用します。COBOL 宣言には指定された許容桁数を超える値を入れることができますが、その場合に値は切り捨てられることになります。

9999 を超える可能性のある小さな整数の場合は、S9(5) を使用してください。999999999 を超える可能性のある大きな整数の場合は、S9(10) COMP-3 を用いて10 進数データ・タイプを得てください。COBOL が COBOL PICTURE を超える整数に使用される場合は、列を 10 進数として指定することにより、必ずデータ・タイプが一致し適切に実行されるようにしてください。

COBOL と下線文字: COBOL では下線文字の使用が認められていないため、DCLGEN は表の列名に下線文字があるとハイフン (-) に変換し、生成された構造内で使用します。

DCLGEN (DSN)


COBOL と DBCS: OS/VS COBOL は DBCS をサポートしていませんが、COBOL

の後続のバージョン (VS COBOL II および COBOL/370) ではサポートしています。COBOL データ定義ステートメント内では、X'41' から X'FE' の範囲外にある値でも DB2 は受け入れますが、データ名における各 2 バイト文字の両方のバイトは、この範囲内になければなりません。データ名には、その先頭バイトとしてX’42’ を持たない DBCS 文字が少なくとも 1 文字は入っていなければなりません。

標識変数の配列のデータ宣言: DCLGEN が標識変数の配列を作成した場合、データ宣言の形式は以下のようになっています。

言語データ宣言

C short int Itable-name[n];

Cobol 01 Itable-name PIC S9(4) USAGE COMP OCCURS n TIMES

PL/I DCL Itable-name(n) BIN FIXED (15);

n は表における列の数です。

例例 1: これは、DCLGEN の使用例です。DSN セッションまたは DB2I から以下のステートメントを発行してください。

DCLGEN TABLE(VEMPL) -LIBRARY(’prefix.SRCLIB.DATA(DSN8MPEM)’) -LANGUAGE(PLI) -APOST

このステートメントは、prefix.SRCLIB.DATA(DSN8MPEM) に以下のステートメントを作成します。

/*********************************************************************//* DCLGEN TABLE(VEMPL) - *//* LIBRARY(’prefix.SRCLIB.DATA(DSN8MPEM)’) - *//* LANGUAGE(PLI) - *//* APOST *//* ... IS THE DCLGEN COMMAND THAT MADE THE FOLLOWING STATEMENTS *//*********************************************************************/EXEC SQL DECLARE VEMPL TABLE

( EMPNO CHAR(6) NOT NULL,FIRSTNME VARCHAR(12) NOT NULL,MIDINIT CHAR(1) NOT NULL,LASTNAME VARCHAR(15) NOT NULL,WORKDEPT CHAR(3) NOT NULL

) ;

/*********************************************************************//* PLI DECLARATION FOR TABLE VEMPL *//*********************************************************************/DCL 1 DCLVEMPL,

5 EMPNO CHAR(6),5 FIRSTNME CHAR(12) VAR,5 MIDINIT CHAR(1),5 LASTNAME CHAR(15) VAR,5 WORKDEPT CHAR(3);

/*********************************************************************//* THE NUMBER OF COLUMNS DESCRIBED BY THIS DECLARATION IS 5 *//*********************************************************************/

DCLGEN (DSN)


例 2: これは、NAMES および STRUCTURE の使用例です。DSN セッションまたは DB2I から以下のステートメントを発行してください。

DCLGEN TABLE(VEMPL) -LIBRARY(’prefix.SRCLIB.DATA(DSN8MPEM)’) -LANGUAGE(PLI) -NAMES(FIELD) -STRUCTURE(EMPRECORD) -APOST

このステートメントは、prefix.SRCLIB.DATA(DSN8MPEM) に以下のステートメントを作成します。

/*********************************************************************//* DCLGEN TABLE(VEMPL) - *//* LIBRARY(’prefix.SRCLIB.DATA(DSN8MPEM)’) - *//* LANGUAGE(PLI) - *//* NAMES(FIELD) - *//* STRUCTURE(EMPRECORD) - *//* APOST *//* ... IS THE DCLGEN COMMAND THAT MADE THE FOLLOWING STATEMENTS *//*********************************************************************/EXEC SQL DECLARE VEMPL TABLE

( EMPNO CHAR(6) NOT NULL,FIRSTNME VARCHAR(12) NOT NULL,MIDINIT CHAR(1) NOT NULL,LASTNAME VARCHAR(15) NOT NULL,WORKDEPT CHAR(3) NOT NULL

) ;

/*********************************************************************//* PLI DECLARATION FOR TABLE VEMPL *//*********************************************************************/DCL 1 EMPRECORD,

5 FIELD1 CHAR(6),5 FIELD2 CHAR(12) VAR,5 FIELD3 CHAR(1),5 FIELD4 CHAR(15) VAR,5 FIELD5 CHAR(3);

/*********************************************************************//* THE NUMBER OF COLUMNS DESCRIBED BY THIS DECLARATION IS 5 *//*********************************************************************/

DCLGEN (DSN)


第 19 章 /DISPLAY (IMS)

この IMS コマンド /DISPLAY は、IMS と外部サブシステム (ならびに、外部サブシステムとの通信を行うすべてのアプリケーション・プログラム) との間の接続の状況、またはそのサブシステムに関連した未解決のリカバリー単位を表示します。


v 『環境』

v 『許可』

v 『構文』


v 126ページの『出力』





管理の手引き: システム」で説明しています。

構文

�� /DISPLAY �

�

,

SUBSYS subsystem-nameALL

,

OASN SUBSYS subsystem-nameALL

��

オプションの説明以下のいずれかのオプションが必要です。

SUBSYS情報の表示を行うサブシステムを識別します。


subsystem-name, ...1 つ以上のサブシステムを指定します。表示される可能性のあるサブシステム状況の説明は、『出力』を参照してください。

ALLすべてのサブシステムに関する情報を表示します。

OASN SUBSYS外部サブシステムに関連した未解決のリカバリー単位 (起点アプリケーション・スケジュール番号、すなわち OASN) を表示します。OASN は、従属領域にアプリケーションをスケジュールするときに IMS によって割り当てられます。これと IMS ID が結合されて、他のサブシステムに分散した作業単位のリカバリー・トークンになります。

subsystem-name, ...1 つ以上のサブシステムを指定してその情報を表示します。

ALLすべての外部サブシステムに関連した未解決のリカバリー単位を表示します。

出力外部サブシステムごとに、コマンド認識文字 (CRC) が表示されます。サブシステムの状況は以下のいずれかです。

CONNECTEDIMS 制御領域または従属領域が、外部サブシステムに正常に接続されました。この時点で、2 つのシステムは通常のダイアログを開始できます。

NOT CONNECTED外部サブシステムがアイドル状態です。つまり、それが /START SUBSYS

コマンドのオブジェクトではなかったか、外部サブシステムの初期設定出口ルーチンが接続しないことを通知しました。

CONNECT IN PROGRESS指定されたサブシステムの接続処理が進行中です。

STOPPED指定されたサブシステムが、/STOP SUBSYS コマンドによって停止しています。指定の外部サブシステムへの領域接続はすべて終了しました。

STOP IN PROGRESS/STOP SUBSYS コマンドが進行中です。このコマンドを正常に完了させるには、すべての IMS 領域からの指定のサブシステムに対するアクティブの接続をすべて静止させる必要があります。

INVALID SUBSYSTEM NAME = subsystem-name

指示されたサブシステム名が、IMS サブシステムの PROCLIB メンバーに定義されていません。サブシステム定義をそのサブシステム・メンバーに追加して、/START SUBSYS コマンドを出してください。

SUBSYSTEM subsystem-name NOT DEFINED BUT RECOVERY OUTSTANDING指示されたサブシステム名が外部サブシステムの PROCLIB メンバーのIMS に定義されていませんが、IMS には名前が知らされた時点でも以前の

/DISPLAY (IMS)


実行からの未解決のリカバリー・エレメントがまだあります。リカバリー・エレメントの問題を解決するには、指示されたサブシステム定義を外部サブシステムの PROCLIB メンバーに追加して、それから /START SUBSYS コマンドを出してください。あるいは、/DISPLAY OASN SUBSYS コマンドを出して OASN の ID を判別し、それから /CHANGE SUBSYS RESET コマンドを出してリカバリー・エレメントを手操作で解決してください。

TERM IN PROGRESSサブシステムの内部終了が進行中です。このタイプの終了は、IMS 異常条件処理、外部サブシステム出口、または外部サブシステムによって引き起こされます。

IMS 従属領域と外部サブシステム間のスレッドは、その領域内のアプリケーション・プログラムが外部サブシステムへの接続を確立するときに作られます。外部サブシステムに対するスレッドの状況は、サブシステムの状況下でリスト表示されます。接続されたサブシステムのもとにスレッドのリストがない場合は、指定のサブシステムへのスレッドが確立されていないことを示します。

スレッドの状況は、以下のいずれかになります。

CONNECTED(CONN)IMS 制御領域または従属領域が、外部サブシステムに正常に接続されました。

ACTIVEIMS アプリケーション・プログラムが、外部サブシステムとの通信を確立しました。

スレッドの PSB 名がない場合は、外部サブシステムへの接続は存在するものの、アプリケーション・プログラムが現時点ではその領域を占有していないことを示します。また、LTERM 名の有無は領域がメッセージ・ドリブンであるかどうかを示すものです。

/DISPLAY コマンドについての前述の説明は部分的なものです。詳しくは、「IMS

コマンド解説書」を参照してください。

例IMS とすべてのサブシステムとの間の接続の状況を表示します。

/DISPLAY SUBSYSTEM ALL

SUBSYS CRC REGID PROGRAM LTERM STATUSSSTR ? CONN

1 DDLTLM17 PTERM01 CONN,ACTIVE2 DDLTLM06 PTERM02 CONN

*85202/065933*

/DISPLAY (IMS)

第 19 章 /DISPLAY (IMS) 127

第 20 章 -DISPLAY ARCHIVE (DB2)

DB2 コマンド DISPLAY ARCHIVE は、入力アーカイブ・ログ情報を表示します。

省略形: -DIS ARC


v 『環境』

v 『許可』

v 『構文』





許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v ARCHIVE システム特権v DISPLAY システム特権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限


構文

�� DISPLAY ARCHIVE ��


使用上の注意データ共用メンバー: コマンド ARCHIVE LOG SCOPE(GROUP) または ARCHIVE

LOG MODE(QUIESCE) はデータ共用グループのすべてのメンバーに対するアーカイブ処理を開始しますが、コマンド DISPLAY ARCHIVE が表示する情報は、対象となったメンバーのものだけです。データ共用グループのすべてのメンバーの入力アーカイブ・ログ情報を表示するには、それぞれのメンバーにコマンドを出してください。

例使用中のアーカイブ・ログ・データ・セットに関する情報を表示するには、次のコマンドを使用します。

-DISPLAY ARCHIVE

このコマンドにより次のような出力が作成されます。

DSNJ322I -DISPLAY ARCHIVE REPORT FOLLOWS-COUNT TIME

(TAPE UNITS) (MIN,SEC)DSNZPARM 2 0,00CURRENT 2 0,00===============================ADDR STATUS CORR-ID VOLSER DATASET_NAME03B0 BUSY SHEDDEN A00001 DSNT2AR1.DT25.D04169.T1328583.A0012701

RECALL 03RCRSC MIGRAT DSNT2AR1.DT25.D04169.T1334426.A0012704A99B BUSY 14DRSTRT ARN690 DSNT2AR1.DT25.D04169.T1346176.A0012705BDDD BUSY 10LPLALR ARN738 DSNT2AR1.DT25.D04170.T1506437.A0012743END OF DISPLAY ARCHIVE REPORT.

この出力例には、以下のものが示されています。

v DSNZPxxx ロード・モジュールに記録された状態の、MAX RTU (COUNT) および DEALLC PERIOD TIME のサブシステム・パラメーター値

v COUNT および TIME パラメーターの現在の指定値

v 割り振られたアーカイブ・ログ・データ・セットの使用可能状況

v 現在のアーカイブ・ログ読み取り要求に関連したボリュームおよびデータ・セット名

-DISPLAY ARCHIVE (DB2)


############

#

#

#

第 21 章 -DISPLAY BUFFERPOOL (DB2)

DB2 コマンド DISPLAY BUFFERPOOL は、1 つ以上のアクティブまたは非アクティブ・バッファー・プールの現在の状況を表示するときに使用します。

省略形: -DIS BPOOL


v 『環境』

v 『許可』







許可このコマンドを実行するには、次のいずれかの特権または権限を含む処理の特権セットを使用する必要があります。v DISPLAY システム特権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限



構文

��

�

ACTIVEDISPLAY BUFFERPOOL( * )

,

bpname

INTERVALDETAIL( )

*

�

�ACTIVE

LIST( )*

ACTIVELSTATS( )

*

�

�

�

*,

DBNAME ( database-name )name1:name2name*

�

�

�

*,

SPACENAM( space-name )name1:name2name*

GBPDEP( YES )NO

�

�CASTOWNR( YES )

NO

��

オプションの説明(ACTIVE)すべてのアクティブ・バッファー・プールの現在のバッファー・プールの状況を表示します。

(*) すべてのアクティブまたは非アクティブ・バッファー・プールの現在のバッファー・プールの状況を表示します。

(bpname)現在の状況を表示するバッファー・プールを指定します。v 4 KB ページのバッファー・プールは、BP0、BP1、...、BP49 と名付けられます。


-DISPLAY BUFFERPOOL (DB2)



v 32 KB ページのバッファー・プールは、BP32K、BP32K1、...、BP32K9 と名付けられます。

DETAIL1 つ以上のバッファー・プールに関する詳細報告書を作成します。DETAIL を指定しなければ、要約報告書が作成されます。

(INTERVAL)最後の増分表示以降、または前の増分表示がない場合はバッファー・プールが最初に活動化された以降に累算された統計を要求します。

(*) バッファー・プールが最初に活動化された以降に累算された統計を要求します。

LIST報告書に組み込まれるバッファー・プールに関連するオープンしている索引スペースおよび表スペースをリストします。非データ共用システムについては基本的な情報が提供され、データ共用がアクティブであれば、より詳細な情報が提供されます。

(ACTIVE)オープンしている索引スペースおよび表スペースのリストを現在使用中のものに限定します。

(*) 現在使用中かどうかに関係なく、オープンしているすべての索引スペースおよび表スペースのリストを要求します。

LSTATS報告書に含めるバッファー・プールに関連する、オープンされている索引スペースと表スペースのデータ・セット統計をリストします。表示される統計は、最後に表示された時点以後の増分です。

(ACTIVE)リスト統計を、現在使用中のデータ・セットだけに限定します。

LIST が指定されていない場合、またはパラメーターなしで LIST を指定した場合、デフォルトは ACTIVE です。パラメーター付きで LIST を指定し、LSTATS にはパラメーターがない場合は、 LIST に指定されたパラメーターが LSTATS に使用されます。

(*) 現在使用中かどうかに関係なく、オープンしているすべての索引スペースおよび表スペースの統計を含めます。

DBNAMELIST 表示および LSTATS 表示に組み込むデータベースを指定します。LIST を指定せずに DBNAME を指定すると、LIST(ACTIVE) が想定されます。

省略形: DBN

(database-name, ...)LIST および LSTATS 表示に組み込む 1 つ以上のデータベースを指定します。database-name の形式は、以下のリストに示される任意の形式です。このリストでは、 name1 および name2 は 1 ～ 8 文字のストリングを表し、name は 1 ～ 8 文字のストリングを表しています。


第 21 章 -DISPLAY BUFFERPOOL (DB2) 133

形式状況表示の対象

name1 データベース name1

name1:name2 データベース名のソートされたリストで name1 からname2 の名前が付けられたすべてのデータベース

name* 名前の先頭がストリング name のすべてのデータベース

(*) LIST 指定に一致するすべてのデータベースの情報を表示します。これはデフォルトです。

SPACENAM指定されたデータベース内で LIST 表示および LSTATS 表示に組み込む表スペースまたは索引スペースを指定します。SPACENAM を指定して DBNAME を指定しない場合は、DBNAME(*) が想定されます。

省略形: SPACE

(*) 指定されたデータベースの、すべての表スペースと索引スペースの情報を表示します。これはデフォルトです。

(space-name, ...)LIST および LSTATS 表示に組み込む 1 つ以上のスペースを指定します。以下のものを指定する場合には、space-name を database-name の場合と同様に記述することができます。v 単一の表スペースまたは索引スペースの名前v 名前の範囲v 名前の一部分を指定して、その後ろにパターン・マッチング文字を付けたもの

GBPDEPデータ・セットのリストを、グループ・バッファー・プール従属のデータ・セットに限定するかどうかを指定します。これがデータ共用でない DB2 の場合、このオプションは無効です。

(YES)ページ・セットのリストを、グループ・バッファー・プール従属 (GBP 従属) ページ・セットに限定します。索引スペースまたは表スペースが GBP

従属であるのは、以下のいずれかの条件に一致する場合です。

v その中に DB2 間読み書きインタレストがある。

v そのスペースからの変更ページがグループ・バッファー・プール内に存在し、その変更ページがディスクにまだ書き込まれていない。

(NO)ページ・セットのリストを、グループ・バッファー・プール従属でないページ・セットに限定します。

CASTOWNRデータ・セットのリストを、この DB2 メンバーがキャストアウト所有者となっているデータ・セットに限定するかどうかを指定します。これがデータ共用でない DB2 の場合、このオプションは無効です。

(YES)ページ・セットのリストを、この DB2 メンバーがキャストアウト所有者となっているページ・セットに限定します。



(NO)ページ・セットのリストを、この DB2 メンバーがキャストアウト所有者でないページ・セットに限定します。

出力要約報告書または詳細報告書を要求することができます。

要約報告書要約報告書には、 137ページの例 1 に示されるように、次の情報が含まれます。

ID

BUFFERPOOL NAME

バッファー・プール外部名 (BP0、BP1、...、BP49、または BP32K、BP32K1、...、BP32K9)

BUFFERPOOL ID

バッファー・プール内部 ID (0-49、80-89、100-109、120-129)。

USE COUNT

このバッファー・プールを参照するオープンしている表スペースまたは索引スペースの数 (非アクティブ・プールの使用回数はゼロ)

BUFFERPOOL SIZE

ユーザー指定のバッファー・プール・サイズ。

BUFFERS ALLOCATED

アクティブ・バッファー・プールで割り振られたバッファー数

TO BE DELETED

アクティブ・バッファー・プールで削除されたバッファー数 (プール縮小による)

IN-USE/UPDATED

現在バッファー・プール内でアクティブ状態 (スチールできない) のバッファー数

BUFFERS ACTIVE

現在バッファー・プール内でアクティブの (データを収容している) バッファー数。ページ固定されたバッファー・プールの場合、BUFFERS ACTIVE

は、実記憶にページ固定されているバッファー数も示します。

しきい値

VP SEQUENTIAL

バッファー・プールの順次スチールしきい値

DEFERRED WRITE

バッファー・プールの据え置き書き出ししきい値

VERTICAL DEFERRED WRT

バッファー・プールの垂直据え置き書き出ししきい値

PARALLEL SEQUENTIAL

バッファー・プールの並列順次しきい値



|

|

|

|

|

|

|

|

|

ASSISTING PARALLEL SEQT

バッファー・プールの補助並列順次しきい値

詳細報告書詳細報告書には、すべての要約報告書情報と追加バッファー・プール関連統計情報が含まれています。ユーザーは累積統計 (DB2 始動以降の蓄積) または増分統計(最後の増分表示以降の蓄積) を要求することができます。報告書のサンプルが 138

ページの例 2 に示されています。詳細報告書の統計は、以下のカテゴリーに分類されます。

ページ取得情報 (メッセージ DSNB411I):

RANDOM GETPAGE

非順次ページ取得要求

SYNC READ I/O(R)

非順次ページ取得の同期読み取り入出力操作

SEQ. GETPAGE

順次ページ取得要求

SYNC READ I/O(S)

順次ページ取得の同期読み取り入出力操作

DMTH HIT

データ管理しきい値の到達回数

PAGE-INS REQ

読み取り I/O に必要となったページイン数

順次プリフェッチ統計 (メッセージ DSNB412I):

REQUESTS

順次プリフェッチ要求

PREFETCH I/O

順次プリフェッチ読み取り入出力操作

PAGES READ

順次プリフェッチによる読み取りページ数

リスト・プリフェッチ統計 (メッセージ DSNB413I):

REQUESTS

リスト・プリフェッチ要求

PREFETCH I/O

リスト・プリフェッチ読み取り入出力操作

PAGES READ

リスト・プリフェッチによる読み取りページ数

動的プリフェッチ統計 (メッセージ DSNB414I):

REQUESTS

動的プリフェッチ要求



|

|

PREFETCH I/O

動的プリフェッチ読み取り入出力操作

PAGES READ

動的プリフェッチによる読み取りページ数

使用不可プリフェッチ統計 (メッセージ DSNB415I):

NO BUFFER

使用不可プリフェッチ - バッファーなし

NO READ ENGINE

使用不可プリフェッチ - 読み取り処理プログラムなし

ページ更新統計 (メッセージ DSNB420I):

SYS PAGE UPDATES

システム・ページ更新

SYS PAGES WRITTEN

システム・ページ書き込み

ASYNC WRITE I/O

非同期書き込み入出力操作

SYNC WRITE I/O

同期書き込み入出力操作

PAGE-INS REQ

読み取り I/O に必要となったページイン数

ページ書き込み統計 (メッセージ DSNB421I):

DWT HIT

据え置き書き出ししきい値の到達回数

VERTICAL DWT HIT

垂直据え置き書き出ししきい値の到達回数

NO WRITE ENGINE

書き込み処理プログラムが入出力操作に使用できなかった回数

並列処理活動 (メッセージ DSNB440I):

PARALLEL REQUEST

並列処理活動のタスク・ストリームについてのネゴシエーション回数

DEGRADED PARALLEL

操作モードの低下を招いたネゴシエーション回数

例例 1: DETAIL オプションが指定されていないと、要約報告書がデフォルトの報告書になります。この例は、次のコマンドで作成できる要約報告書を示しています。

-DISPLAY BUFFERPOOL(BP0) LIST(*) DBNAME(DSN8*)



例 2: すべての要約報告書情報と追加バッファー・プール関連統計情報が含まれた詳細報告書を生成することができます。この例は、次のコマンドで作成できる詳細報告書を示しています。

-DISPLAY BUFFERPOOL(BP0) DETAIL

DSNB401I - BUFFERPOOL NAME BP0, BUFFERPOOL ID 0, USE COUNT 20DSNB402I - BUFFERPOOL SIZE = 2000

BUFFERS ALLOCATED = 2000TO BE DELETED = 0IN-USE/UPDATED = 0BUFFERS ACTIVE = 2000

DSNB404I - THRESHOLDS -VP SEQUENTIAL = 80DEFERRED WRITE = 85VERTICAL DEFERRED WRT = 80PARALLEL SEQUENTIAL = 50ASSISTING PARALLEL SEQT = 0

DSNB406I - PGFIX ATTRIBUTE -CURRENT = NOPENDING = YESPAGE STEALING METHOD = LRU

DSN9022I - DSNB1CMD ’-DISPLAY BUFFERPOOL’ NORMAL COMPLETION



例 3: 要約報告書または詳細報告書を使用し、バッファー・プールに関連付けられているオープンされている表スペースと索引スペースとをリストすることができます。リスト出力された表スペースおよび索引スペースごとに、統計の表示を要求することもできます。この情報を生成する報告書の例は、次のコマンドで作成することができます。

-DISPLAY BUFFERPOOL(BP0) LIST LSTATS




DSNB409I - INCREMENTAL STATISTICS SINCE 10:32:48 OCT 23, 1993

DSNB411I - RANDOM GETPAGE = 230 SYNC READ I/O (R) = 180SEQ. GETPAGE = 610 SYNC READ I/O (S) = 20DMTH HIT = 0 PAGE-INS REQ = 40

DSNB412I - SEQUENTIAL PREFETCH -REQUESTS = 0 PREFETCH I/O = 0PAGES READ = 0

DSNB413I - LIST PREFETCH -REQUESTS = 0 PREFETCH I/O = 0PAGES READ = 0

DSNB414I - DYNAMIC PREFETCH -REQUESTS = 0 PREFETCH I/O = 0PAGES READ = 0

DSNB415I - PREFETCH DISABLED -NO BUFFER = 0 NO READ ENGINE = 0

DSNB420I - SYS PAGE UPDATES = 0 SYS PAGES WRITTEN = 0ASYNC WRITE I/O = 0 SYNC WRITE I/O = 0PAGE-INS REQ = 0

DSNB421I - DWT HIT = 0 VERTICAL DWT HIT = 0NO WRITE ENGINE = 0

DSNB440I - PARALLEL ACTIVITY -PARALL REQUEST = 0 DEGRADED PARALL = 0




|




DSNB455I - SYNCHRONOUS I/O DELAYS -AVERAGE DELAY = 22MAXIMUM DELAY = 35TOTAL PAGES = 23



|

第 22 章 -DISPLAY DATABASE (DB2)

DB2 コマンド DISPLAY DATABASE は、以下のオブジェクトの状況についての情報を表示します。

v DB2 データベース

v 表スペース

v セグメント表スペース内の表

v LOB 表スペース

v データベースの索引スペース

v 補助表に対する索引

v パーティション表スペースのパーティション

v 索引スペースのパーティション

DISPLAY DATABASE RESTRICT は、表スペース、索引スペース、またはパーティションがペンディング状況にあるかどうかも示します。ADVISORY オプションをRESTRICT オプションなしで使用すると、状況を報告するだけの助言的なペンディング状態にあるすべてのオブジェクト、例えば、通知情報としての COPY ペンディングや、補助的な警告などの状況を報告するだけの助言的な状態にあるオブジェクトを表示することができます。

データ共用環境においては、このコマンドはデータベースにアクセスするグループ内のどの DB2 サブシステムからでも出せます。

省略形: -DIS DB


v 『環境』










許可DISPLAY システム特権を用いると、データベースに関する状況情報を表示することができます。表示結果には、1 次許可 ID または任意の 2 次許可 ID が有するDISPLAYDB 特権の対象となるデータベースが示されます。特権のセットに以下の特権または権限のいずれかが組み込まれていないデータベースが指定された場合は、エラー・メッセージが作成されます。v DISPLAYDB 特権v DISPLAY 特権v DBMAINT 権限v DBCTRL 権限v DBADM 権限v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限


-DISPLAY DATABASE (DB2)


構文

�� DISPLAY DATABASE �

,

( database-name )*dbname1:dbname2dbname**dbname*dbname**dbstring1*dbstring2*

�

�

�

USECLAIMERSLOCKSLPLWEPR

,

SPACENAM( space-name )*spacename1:spacename2 USE ONLYspacename* CLAIMERS*spacename LOCKS*spacename* LPL*spacestring1*spacestring2* WEPR

(1)ONLY

�

�

�

,

PART( integer )integer1:integer2

(2)OVERVIEW

�

�50

LIMIT( integer )*

�

�

�

restrict-blockAFTER ACTIVE ADVISORY ( )

,

ICOPYAUXWARBDPAREO*

��

注:

1 SPACENAM() キーワードを指定せずに ONLY オプションを指定すると、LIMIT、AFTER、および RESTRICT キーワードだけが適用されます。

2 OVERVIEW キーワードが指定できるのは、SPACENAM、LIMIT、およびAFTER キーワードと一緒の場合だけです。


第 22 章 -DISPLAY DATABASE (DB2) 143

restrict block:

��

�

,

RESTRICT ( )ACHKPCHKPCOPYGRECPLPLRBDPRECPREORPROSTOPUTUTROUTRWUTUTUT*WEPR

��

オプションの説明(database-name, ...)状況の表示が行われる 1 つ以上のデータベースを指定します。

(*) 処理の特権セットが必要な許可を有している、 DB2 サブシステムに定義されたすべてのデータベースに関する情報を表示します。

dbname と dbstring は、表 16 に記載されている任意の形式をとることができます (この表では、dbname1 と dbname2 は 1 ～ 8 文字の任意の文字ストリングを表し、dbname は 1 ～ 7 文字の任意の文字ストリングを表します)。

表 16. dbname と dbstring の形式


dbname1:dbname2 dbname1 と dbname2 の間の名前を含むすべてのデータベース

dbname* 名前がストリング dbname で始まるすべてのデータベース

*dbname 名前がストリング dbname で終わるすべてのデータベース

*dbname* 名前にストリング dbname を含むすべてのデータベース

*dbstring1*dbstring2* 名前にストリング dbstring1 と dbstring2 を含むすべてのデータベース

SPACENAM表示するスペースを指定します。SPACENAM を用いる場合は、対応するデータ



ベース名も指定しなければなりません。複数のデータベースを指定するのに (*)

を使用する場合、SPACENAM(*) を指定して、そのデータベースのすべてのオブジェクトを表示できます。

省略形: SPACE, SP

(space-name, ...)状況の表示を行う 1 つ以上のスペースをリスト表示します。以下のものを指定する場合には、space-name を database-name の場合と同様に記述することができます。v 単一の表スペースまたは索引スペースの名前v 名前の範囲v 部分的な名前 (開始部分または終了部分のパターン・マッチング文字

(*)、2 つのストリング間のパターン・マッチング文字、またはこれらの任意の組み合わせを含む)。ただし、以下の例外があります。連続したパターン・マッチング文字 (*) は許されず、またキーワード・ストリングの中に 2 つのパターン・マッチング文字を指定することはできません。

(*) 指定されたデータベースの、すべての表スペースと索引スペースに関する情報を表示します。

spacename と spacestring は、表 17 にリストされている任意の形式をとることができます (この表では、spacename1 と spacename2 は 1 ～ 8 文字の任意の文字ストリングを表し、spacename は 1 ～ 7 文字の任意の文字ストリングを表します)。

表 17. spacename と spacestring の形式


spacename1:spacename2 spacename1 と spacename2 の間の名前を含むすべての表スペースまたは索引スペース

spacename* 名前がストリング spacename で始まるすべての表スペースまたは索引スペース

*spacename 名前がストリング spacename で終わるすべての表スペースまたは索引スペース

*spacename* 名前にストリング spacename を含むすべての表スペースまたは索引スペース

*spacestring1*spacestring2* 名前にストリング spacestring1 と spacestring2 を含むすべての表スペースまたは索引スペース

USE次の情報を表示します。

v クレームまたはドレーンを含むデータベースまたはスペースのアプリケーションとサブシステム

v スペース・ロックの保留または待ち合わせ対象となるデータベースまたはスペースのアプリケーションとサブシステム

v 状況が表示されているスペースやパーティションに割り振られたすべてのアプリケーションの接続 ID、相関 ID、および許可 ID

v ローカル・データベースにアクセスするリモート・スレッドの LUWID とロケーション



#

#

CLAIMERS次の情報を表示します。

v 状況が表示されている表スペース、索引スペース、およびパーティションすべてに対するクレーム


v 状況が表示されているスペースに割り振られたすべてのアプリケーションの接続 ID、相関 ID、および許可 ID

v 論理クレームのある論理パーティション、およびそれらに関連したクレーム

CLAIMERS は LOCKS と USE の両方をオーバーライドします。CLAIMERS

を指定した場合、LOCKS や USE は無視されます。

LOCKS次の情報を表示します。

v データベースやスペースに対するロックの保留、待機、または保存を生じさせたアプリケーションおよびサブシステム

v 状況が表示されている表スペース、表、索引スペース、およびパーティションすべてのトランザクション・ロック

v 状況が表示されているスペースに割り振られたすべてのアプリケーションの接続 ID、相関 ID、および許可 ID


v 実行中のジョブが保持するリソースの、ドレーン・ロック

v ドレーン・ロックのある論理パーティション、およびそれらに関連したドレーン・ロック

v リソースの保持ロック

v リソースのページ・セットまたはパーティション物理ロック (P ロック)

LOCKS は USE をオーバーライドします。LOCKS と USE の両方が指定されていると、USE が無視されます。

DB2 ロッキングの説明については、「DB2 管理ガイド」第 5 部 (第 2 巻) を参照してください。

LPL論理ページ・リスト項目を表示します。

WEPR書き込みエラー・ページ範囲の情報を表示します。

ONLY指定されたオブジェクトに関する情報を表示します。

SPACENAM() キーワードなしデータベース情報だけを表示します。DB2 は、DISPLAY DATABASE コマンドで指定したデータベースのスペースに関する情報は表示しません。ONLY を指定する場合は、次のキーワードが有効です。v RESTRICT

v LIMIT

v AFTER



SPACENAM() キーワードありDISPLAY DATABASE コマンドで要求された情報を持つ表スペースまたは索引を表示します。SPACENAM() ONLY を指定する場合は、次のいずれかのキーワードも指定する必要があります。v USE

v CLAIMERS

v LOCKS

v LPL

v WEPR

LOCKS と ONLY の両方のキーワードを指定すると、DB2 は表を表ロックと一緒に表示します。

PART (integer, ...)状況を表示する 1 つ以上のパーティションのパーティション番号を指定します。指定する integer は、対応するスペース名およびデータベース名の有効なパーティション番号でなければなりません。integer を指定して、以下のいずれかの値を指定することができます。v 1 つ以上のパーティションのリストv 照合順序が integer1 以上で integer2 以下のすべてのパーティション番号の範囲

v リストと範囲の組み合わせ

OVERVIEWデータベースの各オブジェクトをその専用行に表示して、データベースのすべてのオブジェクトが簡単に見えるようにします。

OVERVIEW は、指定されたデータベースに含まれているスペース名とスペース・タイプに限定して表示します。パーティション化されたすべてのスペースについて、そのパーティション数が表示されます。

OVERVIEW キーワードが指定できるのは、SPACENAM、LIMIT、およびAFTER キーワードと一緒の場合だけです。

LIMITコマンドによって表示されるメッセージ数を制限します。

(integer)表示されるメッセージの最大数です。デフォルトは 50 です。表示できるメッセージの最大数は、使用可能なスペースによって制限されます。

(*) 使用可能なスペースに表示を限定します。

AFTER次の情報を表示します。

v データベース名のみが使用されると、AFTER はその名前より照合順が大きい名前をもつすべてのデータベースの表示を続行します。

v SPACENAM と、表スペース名または索引スペース名が使用されると、AFTER はその名前より照合順が大きい名前をもつ、同じデータベースの他のすべての表スペースまたは索引スペースまで表示を継続します。



|

|

|

|

|

|

|

|

|

AFTER が使用できない条件があります。それは、データベース名の中にパターン・マッチング文字 (*) を指定した場合に、または SPACENAM() キーワードを指定した場合に、複数の名前を持つデータベース、表スペース、または索引スペースと一緒に使用できません。

ACTIVE表示を、アプリケーションに内部 DB2 リソースが割り振られていて開始状態にある表スペースまたは索引スペースに限定するか、そのようなスペースを含むデータベースに限定します。

省略形: A

デフォルト: ACTIVE も RESTRICT も使用しない場合は、DB2 に定義されたすべてのデータベースに関する情報を表示します。

RESTRICT制限された状況にあるデータベース、表スペース、または索引スペースに表示を限定します。これには、論理ページ・リスト項目を持つページ・セットが含まれます。キーワードを 1 つ以上指定することにより、さらに表示を指名オブジェクトのみに制限することができます。

省略形: RES

データベースは、以下のいずれかの状態のときはその使用が制限されます。v 読み取り専用処理用に開始された場合v ユーティリティー専用処理用に開始された場合v 停止されている場合

表スペースまたは索引スペースが以下のいずれかの状態の場合は、表スペースまたは索引スペースの使用は制限されます。v 上記の 3 つの状態のいずれかである場合v ユーティリティーにより処理されている場合v COPY ペンディング、CHECK ペンディング、RECOVER ペンディング、グループ・バッファー・プール RECOVER ペンディング、補助 CHECK ペンディング、または REORG ペンディング状況になっている場合

v ページ誤差範囲が含まれている場合v 論理ページ・リスト (LPL) のページが含まれている場合

リストされるオブジェクトを制限するには、次のキーワードを 1 つ以上指定してください。

ACHKP 補助警告助言状態にあるオブジェクトを表示します。

CHKP CHECK ペンディング状況のオブジェクトを表示します。

COPY COPY ペンディング状況のオブジェクトを表示します。

GRECP グループ・バッファー・プール RECOVER ペンディング状況のオブジェクトを表示します。

LPL 論理ページ・リスト項目を表示します。

RBDP REBUILD ペンディングまたは RECOVER ペンディング状況の索引オブジェクトを表示します。この状態には、制限状態RBDP、LPL、および WEPR が含まれます。

RECP RECOVER ペンディング状況のオブジェクトを表示します。こ



の状況には、制限状態 RECP、RECP*、LPL、および WEPR

(書き込みエラー・ページ範囲) が含まれます。

REORP REORG ペンディング状況のオブジェクトを表示します。

RO 読み取り専用モードになっているオブジェクトを表示します。

STOP 停止しているオブジェクトを表示します。この状態には、制限状態 STOP、STOPE、STOPP、および LSTOP が含まれます。

UT ユーティリティー・アクセス・モードになっているオブジェクトを表示します。

UTRO ユーティリティー・アクセス用に順番に並べられ、読み取り専用アクセスが可能なオブジェクトを表示します。

UTRW ユーティリティー・アクセス用に順番に並べられ、読み取り /

書き込みアクセスが可能なオブジェクトを表示します。

UTUT ユーティリティー・アクセス用に順番に並べられ、使用不可能なオブジェクトを表示します。

UT* UT、UTRW、UTRO、または UTUT のいずれかのユーティリティー・アクセス・モードにあるオブジェクトを表示します。

WEPR 書き込みエラー・ページ範囲の情報を表示します。

ADVISORY索引と表スペースの表示を、読み取り / 書き込みアクセスが許されているが、何らかのアクションを取ることが推奨されているもの、に限定します。

省略形: ADV

次の情報を判別するには、RESTRICT オプションを指定せずに DISPLAY

DATABASE ADVISORY コマンドを使用します。v 索引スペースが、情報を知らせるだけの COPY ペンディング (ICOPY) 助言状況にある場合

v 基本表または LOB 表スペースが、補助警告 (AUXW) 助言状況にある場合v 索引スペースが、REBUILD ペンディング (ARBDP) 助言状況にある場合v 索引スペースが、REORG (AREO*) 助言状況にある場合

リストされるオブジェクトを制限するには、次のキーワードを 1 つ以上指定してください。

AUXW補助警告の助言状態にあるオブジェクトを表示します。

ICOPY情報を知らせるだけの COPY ペンディングの助言状態にあるオブジェクトを表示します。

ARBDP助言状況の REBUILD ペンディング状況のオブジェクトを表示します。

AREO*助言状況の REORG ペンディング状況にあるオブジェクトを表示します。



|

|

|

|

|

|

|

助言状況のリセット方法については、「DB2 ユーティリティー・ガイドおよび解説書」第 2 部を参照してください。

使用上の注意DB2 カタログ表の表示: DB2 カタログ表は、いつでも表示することができます。しかし、ユーザー・データベースやユーザー表スペースに関する情報が入っているカタログの表スペースが停止した場合は、これらのデータベースまたは表スペースを表示することはできません。表示しようとするとエラーが生じます。表スペース名および割り当てられる表のリストについては、「DB2 SQL 解説書」付録 F を参照してください。

カタログ (DSNDB06) に DISPLAY DATABASE LOCKS を出すと、 SYSDBASE

に相関 ID 020.DBCMD_05 または 020.DBCMD_06 を使用して、ロックが保留されていることがあります。これは、DISPLAY DATABASE 自身が必要とするロックを示していて正常です。

制限付き、助言状況にあるオブジェクトの表示: 制限付き状況にあるすべてのリソースを表示するには、DISPLAY DATABASE コマンドを 2 回発行する必要があります。制限付き状況にある表スペースと索引を表示するためには、RESTRICT を指定した SPACENAM パラメーターを使用してください。制限付き状況のデータベースを表示する場合は、SPACENAM パラメーターは使用しないでください。データベースが制限付き状況にある場合、スペースは、それらが RW モードであっても使用不可になる可能性があります。

助言状況にあるすべてのリソースを表示するには、 RESTRICT オプションを指定せずに DISPLAY DATABASE ADVISORY コマンドを出します。制限状況または助言状況のリセットについては、「DB2 ユーティリティー・ガイドおよび解説書」第 2

部を参照してください。

通信データベース (CDB) とリソース限定機能 (RLF): 通信データベースまたはアクティブなリソース限定機能データベースの表スペースまたは索引スペースをコマンドで指定すると、指定した表スペースまたは索引スペースを使用中のデータ共用グループの全メンバー名が USE オプションにより表示されます。そのデータ共用グループの他のメンバーのうち、これらのスペースを使用している可能性のあるメンバーがどれかを知っておくと、通信データベースやリソース限定機能データベースにある表スペースおよび索引スペースを除去するかどうかを考慮するにあたって参考になります。

論理パーティションの表示: タイプ 2 索引の論理パーティションに対して PART

パラメーターを指定して DISPLAY DATABASE を発行した場合、DB2 は出力で物理クレイマー (claimer) と物理ロックを表示しません。パーティション表に対するパーティション化されていない索引はタイプ 'IX' で表示され、パーティション番号は'L' とその後に続く 4 桁の数字で表示されます。論理パーティション・レベルで表示する情報がない場合は、パーティション番号 'L*' として表示されます。

宣言済みの一時表のデータベースの表示: DISPLAY DATABASE コマンドで表示されるのは、AS TEMP オプションを指定して作成されたデータベースに関する情報と、関連する表スペースに関する情報です。このコマンドでは、そのデータベースに含まれる、宣言済みの一時表や索引スペースについての情報は表示されません。



データ・パーティション 2 次索引 (DPSI): DISPLAY DATABASE はデータ・パーティション 2 次索引に関する情報を表示します。 DPSI は、タイプ 'IX' で表示されます。パーティション番号は、'D' とその後に続く 4 桁の数字 (0001 ～ 4096) として表示されます。

出力メッセージ DSNT392I 状況情報: DISPLAY DATABASE コマンドにより表示される状況コード、および各コードの説明は次のとおりです。

ARBDP

この索引を再作成して、パフォーマンスを改善し、DB2 サブシステムが索引用にのみアクセスするためにこの索引を選択できるようにする必要があることを示します。

AREO*

表示された表スペース、索引、またはパーティションを再編成してパフォーマンスを最適化する必要があることを示します。

ACHKP

基本表の LOB 列のエラーを示します。基本表は、補助 CHECK ペンディングの制限状況になります。

AREST

オブジェクト (表スペース、索引スペース、または表スペースや索引スペースの物理パーティション) が助言 RESTART ペンディング状態にあることを示します。オブジェクトに対するバックアウト・アクティビティーをまだ実施していない場合は、RECOVER POSTPONED コマンドを発行するか、またはシステム・パラメーター LBACKOUT=AUTO を使用してシステムをリサイクルすることにより、バックアウトを開始してください。

AUXW

基本表が補助警告助言状況にあり、LOB 列にエラーがあることを示しているか、または LOB 表スペースが補助警告助言状況にあり、無効な LOB であることを示しているかのいずれかです。

CHKP オブジェクト (表スペース、表スペース内のパーティション、または索引)

が CHECK ペンディング状況になっています。

COPY オブジェクト (表スペース、または表スペース内のパーティション) がCOPY ペンディング状況になっています。このオブジェクトにはイメージ・コピーが必要です。

GRECP

このオブジェクトは GBP 従属で、グループ・バッファー・プールRECOVER がペンディング中です。

ICOPY 索引スペースが、情報を知らせるだけの COPY ペンディング助言状況になっています。

LPL このオブジェクトは論理ページ・リストに項目があります。

LSTOP

非パーティション索引の論理パーティションが停止しています。



|

|

|

|

|

|

|

PSRBD

非パーティション索引スペース全体がページ・セット REBUILD ペンディング状況です。

RBDP 物理または論理索引パーティションが REBUILD ペンディング状況です。

RBDP*

非パーティション索引の論理パーティションが REBUILD ペンディング状況であり、索引全体が SQL アプリケーションにアクセス不能です。ただし、再作成を必要とするのは論理パーティションだけです。

RECP オブジェクト (表スペース、表スペース・パーティション、索引スペース、索引パーティション、または論理索引パーティション) が RECOVER ペンディング状況になっています。

REFP オブジェクト (表スペース、索引スペース、または索引) が REFRESH ペンディング状況になっています。

RELDP

オブジェクトは、リリースに依存します。

REORP

データ・パーティションが REORG ペンディング状況になっています。

RESTP 表スペースまたは索引スペースが再始動ペンディング状況になっています。

RO データベース、表スペース、表スペース・パーティション、索引スペース、または索引スペース・パーティションが、読み取り専用アクティビティーで開始されます。

RW データベース、表スペース、表スペース・パーティション、索引スペース、または索引スペース・パーティションが、読み取り / 書き込みアクティビティーで開始されます。

STOP データベース、表スペース、表スペース・パーティション、索引スペース、または索引スペース・パーティションが、停止しています。

STOPE

ページのログ RBA に問題があるため、表スペースまたは索引スペースが暗黙に停止しました。エラーの検出時にメッセージ DSNT500I またはDSNT501I が出され、不整合があることを示します。

STOPP データベース、表スペース、表スペース・パーティション、索引スペース、または索引スペース・パーティションに対して、停止がペンディング中です。

UT データベース、表スペース、表スペース・パーティション、索引スペース、または索引スペース・パーティションが、ユーティリティー処理専用で開始されます。

UTRO 表スペース、表スペース・パーティション、索引スペース、または索引スペース・パーティションにおいて、ユーティリティーが処理中です。このユーティリティーでは、RO アクセスのみが可能です。オブジェクトがドレーンされる前にユーティリティーが取り消されると、このオブジェクトはユーティリティーによって変更されていないため、SQL アクセスをすることが可能になります。

UTRW 表スペース、表スペース・パーティション、索引スペース、または索引スペ



ース・パーティションにおいて、ユーティリティーが処理中です。このユーティリティーでは、RW アクセスが可能です。

UTUT 表スペース、表スペース・パーティション、索引スペース、または索引スペース・パーティションにおいて、ユーティリティーが処理中です。このユーティリティーでは、UT アクセスのみが可能です。オブジェクトがドレーンされる前にユーティリティーが取り消されると、このオブジェクトはユーティリティーによって変更されていないため、SQL アクセスをすることが可能になります。

WEPR 書き込みエラー・ページ範囲の情報を表示します。

例例 1: データベース CB3 の表スペース TBS33 についての情報を表示します。USE オプションを使用すると、 connection-name(CONNID)、 correlation-id

(CORRID)、および authorization ID (USERID) の情報が表示されます。

-DISPLAY DATABASE(CB3) SPACENAM(TBS33) USE

次の出力が生成されます。

DSNT360I - ***********************************************************DSNT361I - * DISPLAY DATABASE SUMMARY

* GLOBAL USEDSNT360I - ***********************************************************DSNT362I - DATABASE = CB3 STATUS = RW

DBD LENGTH = 4028DSNT397I -NAME TYPE PART STATUS CONNID CORRID USERID-------- ---- ----- ----------------- -------- ------------ --------TBS33 TS 0001 RW LSS001 DSN2SQL SYSADMTBS33 TS 0002 RW LSS001 DSN2SQL SYSADMTBS33 TS 0003 RW LSS001 DSN2SQL SYSADMTBS33 TS 0004 RW LSS001 DSN2SQL SYSADM

******* DISPLAY OF DATABASE CB3 ENDED **********************DSN9022I . DSNTDDIS ’DISPLAY DATABASE’ NORMAL COMPLETION

例 2: データベース CB3 の表スペース TBS33 についての情報を表示します。LOCKS オプションが表示するロック情報は、指定された表スペースと表、任意のリモート・スレッドの LUWID とロケーション、そして connection-name、correlation-id、および authorization ID についての情報です。

-DISPLAY DATABASE(CB3) SPACENAM(TBS33) LOCKS



* GLOBAL LOCKSDSNT360I - ***********************************************************DSNT362I - DATABASE = CB3 STATUS = RW

DBD LENGTH = 4028DSNT397I -NAME TYPE PART STATUS CONNID CORRID LOCKINFO-------- ---- ----- ----------------- -------- ------------ ---------TBS33 TS 0001 RWTBS33 TS 0002 RWTBS33 TS 0003 RWTBS33 TS 0004 RW LSS004 DSN2SQL H(IS,S,C)



||||||

||||||

TBS33 TS 0004 RW LSS005 DSN2SQL H(IS,S,C)

******* DISPLAY OF DATABASE CB3 ENDED **********************

例 3: データベース CB3 の中の表スペース TBS33 についての情報を表示します。CLAIMERS オプションが表示する情報は、クレームのタイプと期間、任意のリモート・スレッドの LUWID とロケーション、および connection-name、correlation-id、および authorization ID についての情報です。

-DISPLAY DATABASE(CB3) SPACENAM(TBS33) CLAIMERS



* GLOBAL CLAIMERSDSNT360I - ***********************************************************DSNT362I - DATABASE = BP1DB STATUS = RW

DBD LENGTH = 4028DSNT397I -NAME TYPE PART STATUS CONNID CORRID CLAIMINFO-------- ---- ----- ----------------- -------- ------------ --------BP1TS TS 0001 RW,UTRW BATCH UPD1W (WR,C)BP1TS TS 0001 RW,UTRW BATCH UPD1W (CS,C)BP1TS TS 0001 RW,UTRW UTILITY REORG1 (CS,A)BP1TS TS 0002 RW,UTRW UTILIT REORG1 (CS,A)BP1TS TS 0003 RW,UTRW UTILITY REORG1 (CS,A)BP1TS TS 0004 RW,UTRW UTILITY REORG1 (CS,A)BP1TS TS RW BATCH UPD1W (WR,C)BP1TS TS RW BATCH UPD1W (CS,C)

******* DISPLAY OF DATABASE BP1DB ENDED *********************

例 4: データ共用環境において、表スペース用に保持されているロックについての情報を表示します。メンバー DB1G 上で LSS001 として識別されたアプリケーションが、パーティション 1 と 2 をロックしており、メンバー DB2G 上の LSS002

がパーティション 1 と 3 をロックしています。パーティション 4 についてはロックは保持されていません。

-DISPLAY DATABASE(DSN8D51A) SPACENAM(TSPART) LOCKS


NAME TYPE PART STATUS CONNID CORRID LOCKINFO-------- ---- ----- ----------------- -------- ------------ ---------TSPART TS 0001 RO LSS001 DSN2SQL H-IS,P,C

- MEMBER NAME DB1GTSPART TS 0001 RO H-S,PP,I

- MEMBER NAME DB1GTSPART TS 0001 RO LSS002 DSN2SQL H-IS,P,C


- MEMBER NAME DB2GTSPART TS 0002 RW LSS001 DSN2SQL H-IS,P,C

- MEMBER NAME DB1GTSPART TS 0002 RW H-S,PP,I

- MEMBER NAME DB1GTSPART TS 0003 RW LSS002 DSN2SQL H-IS,P,C


- MEMBER NAME DB2GTSPART TS 0004 RW



|

###################

|||||||||||||||||||

DB2 がパーティションを選択してロックできない場合は、すべてのパーティションをロックし、次の出力のような表示が行われます。 LOCKINFO フィールドに S の値が表示され、これが表スペース・ロックであることを示しています。パーティションが異なる状況で保持される場合、これらの状況は、表スペースロックの下にリストされます。

NAME TYPE PART STATUS CONNID CORRID LOCKINFO-------- ---- ----- ----------------- -------- ------------ ---------TSPART TS LSS001 DSN2SQL H-IS,S,C

- MEMBER NAME DB1GTSPART TS LSS002 DSN2SQL H-IS,S,C




- MEMBER NAME DB2GTSPART TS 0004 RW

例 5: 論理ページ・リストの中に項目を持つ、データベース DSNDB01 の中のページ・セットについての情報を表示します。表示されるメッセージの数を、使用可能なスペースに限定します。

-DB1G DISPLAY DATABASE(DSNDB01) SPACENAM(*) LIMIT(*) LPL


***********************************************************DSNT361I -DB1G * DISPLAY DATABASE SUMMARY

* GLOBAL LPLDSNT360I -DB1G***********************************************************DSNT362I -DB1G DATABASE = DSNDB01 STATUS = RW

DBD LENGTH = 8000DSNT397I -DB1GNAME TYPE PART STATUS LPL PAGES-------- ---- ----- ----------------- ------------------DBD01 TS RW,LPL,GRECP 000001,000004,00000C,000010---- 000039-00003CSPT01 TS RWSCT02 TS RWSYSLGRNG TS RWSYSUTILX TS RWSYSLGRNX TS RW,LPL,GRECP 000000-FFFFFFDSNSCT02 IX RWDSNSPT01 IX RWDSNSPT02 IX RWDSNLUX01 IX RWDSNLUX02 IX RWDSNLLX01 IX RWDSNLLX02 IX RW******* DISPLAY OF DATABASE DSNDB01 ENDED **********************DSN9022I -DB1G DSNTDDIS ’DISPLAY DATABASE’ NORMAL COMPLETION

例 6: DB2 が表スペース TSPART (データベース DSN8D81A に含まれている) のパーティションを選択してロックできないものと仮定します。次のコマンドを指定した結果、2 つのアプリケーションが TSPART にアクセスしていて、パーティションの状況は異なっています。

-DB1G DISPLAY DATABASE(DSN8D81A) SPACE(TSPART) PART(1,4) LOCKS



|||||||||||||

||||||||||||||||

DB2 は、次の出力に示すような表スペース・ロックとして、そのロックを表示します。

NAME TYPE PART STATUS CONNID CORRID LOCKINFO-------- ---- ----- ----------------- -------- ------------ ---------TSPART TS LSS001 DSN2SQL H-IS,S,CTSPART TS LSS002 DSN2SQL H-IS,S,CTSPART TS 0001 ROTSPART TS 0004 RW

例 7: 例えば、表スペース TSPART に ALTER TABLESPACE ステートメントを実行し、TSPART が LOCKPART YES で定義されているものとします。LOCKPART

YES が指定されているため、DB2 は TSPART について選択パーティション・ロッキングを実行します。次のコマンドを指定した場合、2 つのアプリケーションはTSPART にアクセスしています。接続 ID LSS001 で示したアプリケーションがパーティション 1 と 2 をロックしました。接続 ID LSS002 で示したアプリケーションがパーティション 1 と 3 をロックしました。

-DB1G DISPLAY DATABASE(DSN8D81A) SPACE(TSPART) PART(1:4) LOCKS

DB2 は、次の出力のようなパーティション・ロックとして、このロックを表示します。

NAME TYPE PART STATUS CONNID CORRID LOCKINFO-------- ---- ----- ----------------- -------- ------------ ---------TSPART TS 0001 RO LSS001 DSN2SQL H-IS,P,CTSPART TS 0001 RO LSS002 DSN2SQL H-IS,P,CTSPART TS 0002 RW LSS001 DSN2SQL H-IS,P,CTSPART TS 0003 RW LSS002 DSN2SQL H-IS,P,CTSPART TS 0004 RW

例 8: DBKD0101 から DBKD0106 までのデータベース範囲で、制限状況にあるデータベース内のすべての表スペースと索引スペースの情報を表示します。表示されるメッセージの数を、使用可能なスペースに限定します。

-DISPLAY DATABASE(DBKD0101,DBKD0103) SPACENAM(*) RESTRICT LIMIT(*)


DSNT360I - ***********************************DSNT361I - * DISPLAY DATABASE SUMMARY

* RESTRICTEDDSNT360I - ***********************************DSNT362I - DATABASE = DBKD0101 STATUS = RW

DBD LENGTH = 4028DSNT397I -NAME TYPE PART STATUS PHYERRLO PHYERRHI CATALOG PIECE-------- ---- ----- ----------------- -------- -------- -------- -----TLKD0101 TS RW,RESTPIUKD011A IX RW,RESTPIXKD011B IX RW,RESTP

例 9: データベース DBIQUQ01 内の、補助警告助言状況 (AUXW) にあるすべての表スペースの情報と、情報を知らせるだけの COPY ペンディング状況 (ICOPY) になっているすべての索引スペースの情報を表示します。表示されるメッセージの数を、使用可能なスペースに限定します。

-DISPLAY DATABASE(DBIQUQ01) SPACENAM(*) LIMIT(*) ADVISORY




||||||

|||||||

|||||


* ADVISORYDSNT360I - ***********************************DSNT362I - DATABASE = DBIQUQ01 STATUS = RW

DBD LENGTH = 8066DSNT397I -NAME TYPE PART STATUS PHYERRLO PHYERRHI CATALOG PIECE-------- ---- ----- ----------------- -------- -------- -------- -----TPIQUQ01 TS 0001 RW,AUXW

-THRU 0004IAIQUQ01 IX RW,ICOPYIAIQUQ02 IX RW,ICOPYIAIQUQ03 IX RW,ICOPYIAIQUQ04 IX RW,ICOPYIPIQUQ01 IX 0001 RW,ICOPY

-THRU 0004IUIQUQ03 IX RW,ICOPYIXIQUQ02 IX RW,ICOPY******* DISPLAY OF DATABASE DBIQUQ01 ENDED **********************DSN9022I - DSNTDDIS ’DISPLAY DATABASE’ NORMAL COMPLETION

例 10: データベース DB486A 内のすべてのオブジェクトを表示します。この例は、データベース内の 5 つのオブジェクトを示しています。TS486A は、4 つの部分を持つ表スペースであり、TS486C はパーティション化されていない表スペースです。 IX486A は、表スペース TS486A の非パーティション索引であり、IX486B

は、4 つの部分を持つパーティション索引であり、IX486C は非パーティション索引です。

-DISPLAY DATABASE(DB486A) SPACE(*) OVERVIEW



* GLOBAL OVERVIEWDSNT360I - ***********************************DSNT362I - DATABASE = DB486A STATUS = RW

DBD LENGTH = 4028DSNT397I -NAME TYPE PART-------- ---- -----TS486A TS 0004IX486A IX L0004IX486B IX 0004TS486C TSIX486C IX******* DISPLAY OF DATABASE DB486A ENDED **********************DSN9022I - DSNTDDIS ’DISPLAY DATABASE’ NORMAL COMPLETION

例 11: すべての表スペースを探すための SPACE(*) を指定して、データベースDB486B を表示します。この例は、STOP 状況にあるパーティション 1 ～ 6 を持つ表スペース TS486X を示しています。パーティション 7 は UT および COPY

状況、パーティション 8 は STOP 状況、およびパーティション 9 および 10 はRW 状況です。

-DISPLAY DATABASE(DB486B) SPACE(*)



* GLOBAL OVERVIEWDSNT360I - ***********************************



||||||||||||

|

|

|

|

|

|

|

|

||||||||||||||||

|

|

|

|

|

|

||||

DSNT362I - DATABASE = DB486B STATUS = RWDBD LENGTH = 4028

DSNT397I -NAME TYPE PART STATUS PHYERRLO PHYERRHI CATALOG PIECE-------- ---- ----- ----------------- -------- -------- -------- -----TS486X TS 0001 STOP

- THRU 0006TS486X TS 0007 UT,COPYTS486X TS 0008 STOPTS486X TS 0009 RW

- THRU 0010IX486X IX L0001 RWIX486X IX L0002 LSTOP

- THRU L0003IX486X IX L0004 LSTOP

- THRU L0010IX486Y IX 0001 RW

- THRU 0010IX486Z IX RW******* DISPLAY OF DATABASE DB486B ENDED **********************DSN9022I - DSNTDDIS ’DISPLAY DATABASE’ NORMAL COMPLETION

例 12: DBKD0101 データベース内のすべての索引に関する情報を表示します。INDEX2 には、論理レベルで表示する情報が入っています。 INDEX3 のパーティション 0001 および 0002 はデータがパーティション化された 2 次索引で、パーティション番号の 'D' で示されます。

-DISPLAY DATABASE(DBKD0101) SPACENAM(INDEX*)



* RESTRICTEDDSNT360I - ***********************************DSNT362I - DATABASE = DBKD0101 STATUS = RW

DBD LENGTH = 4028DSNT397I -NAME TYPE PART STATUS PHYERRLO PHYERRHI CATALOG PIECE-------- ---- ----- ----------------- -------- -------- -------- -----INDEX1 IX 0001 RW

-THRU 0002INDEX2 IX L* RWINDEX3 IX D0001 RW

-THRU D0002INDEX4 IX L0001 RECPINDEX4 IX L0002 RW

例 13: 助言 REBUILD ペンディング状況 (ARBDP) および助言 REORG 状況(AREO*) になっている DBKD0103 データベース内のすべての表スペースに関する情報を表示します。表示されるメッセージの数を、使用可能なスペースに限定します。次のコマンドを指定するとします。

-DISPLAY DATABASE(DBKD0103) SPACENAM(*) LIMIT(*) ADVISORY(ARBDP,AREO*)



* ADVISORYDSNT360I - ***********************************DSNT362I - DATABASE = DBKD0103 STATUS = RW

DBD LENGTH = 16142DSNT397I -



|||||||||||||||||||||

|

|

|

|

|

||||||||||||||||

|

|

|

|

|

|

|||||||

NAME TYPE PART STATUS PHYERRLO PHYERRHI CATALOG PIECE-------- ---- ----- ----------------- -------- -------- -------- -----PIX IX 0001 RW,ARBDP,AREO*

-THRU 0007

例 14: データベース ’DB2’ の表スペース DB2TSP に関する情報を表示します。PART オプションには、パーティションのセットを特定して表示するためのリストと範囲の両方が含まれます。この表スペースは、単一の ROTATE 操作を受けてから、最終パーティションが追加されます。

-DISPLAY DATABASE(DB2) SPACENAME(DB2TSP) PART(1,2,4:6,9,10:12)



* GLOBALDSNT360I - ***********************************DSNT362I - DATABASE = DB2 STATUS = RW

DBD LENGTH = 4028DSNT397I -NAME TYPE PART STATUS PHYERRLO PHYERRHI CATALOG PIECE-------- ---- ----- ----------------- -------- -------- -------- -----DB2TSP TS 0002 RW,AREO*DB2TSP TS 0004 RWDB2TSP TS 0001 RW,AREO*DB2TSP TS 0005 RW

-THRU 0006DB2TSP TS 0009 RW

-THRU 0012******* DISPLAY OF DATABASE DB2 ENDED ****************************DSN9022I - DSNTDDIS 'DISPLAY DATABASE' NORMAL COMPLETION



||||

第 23 章 -DISPLAY DDF (DB2)

DISPLAY DDF コマンドは、DDF の状況と構成に関する情報を表示し、また DDF

によって制御される接続またはスレッドに関する統計情報も表示します。

省略形: -DIS DDF


v 『環境』

v 『許可』

v 『構文』






許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v DISPLAY 特権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限


構文

�� DISPLAY DDFDETAIL

��


オプションの説明DETAIL詳細な統計および構成情報を表示します。

出力DISPLAY DDF コマンドは、次の出力を表示します。

STATUS DDF の操作上の状況

LOCATION DDF のロケーション名

LUNAME DDF の完全に修飾された LUNAME

GENERICLU DDF の完全に修飾された総称 LUNAME

IPADDR DDF の IP アドレス

TCPPORT DDF により使用される SQL リスナー・ポート

RESPORT DDF により使用される再同期リスナー・ポート

DOMAIN DDF により使用される SQL および再同期ドメイン

例例 1: 次のコマンドを使用して、DDF がまだ開始されていないときの DDF 詳細報告書を表示します。

#display ddf detail


DSNL080I # DSNLTDDF DISPLAY DDF REPORT FOLLOWS:DSNL081I STATUS=STOPDQDSNL082I LOCATION LUNAME GENERICLUDSNL083I STL715B -NONE.SYEC715B -NONEDSNL084I IPADDR TCPPORT RESPORTDSNL085I -NONE 447 5002DSNL086I SQL DOMAIN=-NONEDSNL086I RESYNC DOMAIN=-NONEDSNL090I DT=A CONDBAT= 64 MDBAT= 64DSNL092I ADBAT= 0 QUEDBAT= 0 INADBAT= 0 CONQUED= 0DSNL093I DSCDBAT= 0 INACONN= 0DSNL099I DSNLTDDF DISPLAY DDF REPORT COMPLETE

例 2: 次のコマンドを使用して、DDF が開始済みの状態での DDF 報告書 (詳細ではない) を表示します。

#display ddf


DSNL080I # DSNLTDDF DISPLAY DDF REPORT FOLLOWS:DSNL081I STATUS=STARTDDSNL082I LOCATION LUNAME GENERICLUDSNL083I STL715B USIBMSY.SYEC715B -NONEDSNL084I IPADDR TCPPORT RESPORTDSNL085I 9.112.114.103 447 5002DSNL086I SQL DOMAIN=v7ec103.stl.ibm.comDSNL086I RESYNC DOMAIN=v7ec103.stl.ibm.comDSNL099I DSNLTDDF DISPLAY DDF REPORT COMPLETE

-DISPLAY DDF (DB2)


例 3: 次のコマンドを使用して、DDF が開始済み状態での DDF 詳細報告書を表示します。

#display ddf detail


DSNL080I # DSNLTDDF DISPLAY DDF REPORT FOLLOWS:DSNL081I STATUS=STARTDDSNL082I LOCATION LUNAME GENERICLUDSNL083I STL715B USIBMSY.SYEC715B -NONEDSNL084I IPADDR TCPPORT RESPORTDSNL085I 9.112.114.103 447 5002DSNL086I SQL DOMAIN=v7ec103.stl.ibm.comDSNL086I RESYNC DOMAIN=v7ec103.stl.ibm.comDSNL090I DT=A CONDBAT= 64 MDBAT= 64DSNL092I ADBAT= 1 QUEDBAT= 0 INADBAT= 0 CONQUED= 0DSNL093I DSCDBAT= 0 INACONN= 0DSNL099I DSNLTDDF DISPLAY DDF REPORT COMPLETE

-DISPLAY DDF (DB2)

第 23 章 -DISPLAY DDF (DB2) 163

-DISPLAY DDF (DB2)


第 24 章 -DISPLAY FUNCTION SPECIFIC (DB2)

DB2 コマンド DISPLAY FUNCTION SPECIFIC は、 DB2 アプリケーションがアクセスする外部ユーザー定義関数についての統計を表示します。

省略形: -DIS FUNC SPEC


v 『環境』

v 『許可』







データ共用範囲: グループまたはローカル。SCOPE オプションの値により異なります。

許可このコマンドを実行するには、各機能に対して次の権限のいずれかを含む処理の特権セットを使用する必要があります。v 関数の所有権v DISPLAY 特権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限

DISPLAY FUNCTION SPECIFIC *.* または schema.partial-name* を指定する場合は、次の権限のいずれかを含む、処理の特権セットを使用する必要があります。v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限



|

|

構文

�� DISPLAY FUNCTION SPECIFIC �

�

�

(*.*)

,

( schema.specific-function-name )schema.partial-name*

LOCALSCOPE ( GROUP ) ��

オプションの説明schema.specific-function-name

指定されたスキーマ内の名前を特定された関数について、情報を表示します。SQL で指定できるような形式で関数名を指定することはできず、特定名を使用しなければなりません。CREATE FUNCTION ステートメントで特定の名前を指定しなかった場合は、 SYSIBM.SYSROUTINES を照会して正しい特定名を調べてください。

SELECT SPECIFICNAME, PARM_COUNTFROM SYSIBM.SYSROUTINESWHERE NAME=’function_name’AND SCHEMA=’schema_name’;

多重定義関数の場合、この照会では複数行が返される場合があります。

schema.partial-name*

指定されたスキーマ内の関数のセットについて情報を表示します。

セット内のすべての関数の特定名は、partial-name で始まり、任意のストリング(空白ストリングを含む) で終わることができます。例えば schema1.ABC* は、schema1 内の ABC で始まる特定名を持つ、すべての関数の情報を表示します。

(*.*)DB2 サブシステムの開始以後に DB2 アプリケーションがアクセスした、すべての関数の情報を表示します。

SCOPEコマンドの有効範囲を指定します。

(LOCAL)表示にはローカル・メンバーからの情報のみを含めることを指定します。

(GROUP)表示にはデータ共用グループの全メンバーからの情報を含めることを指定します。



|

|

|

|

|

使用上の注意部分的な関数名または特定の関数名を指定しないと、 DB2 は、DB2 サブシステムの開始以後に DB2 アプリケーションがアクセスした、すべての関数の情報を表示します。

このコマンドは、組み込み関数または、ソースが別の関数にあるユーザー定義関数には適用されません。

出力このコマンドは、DB2 アプリケーションがアクセスした関数ごとに 1 行の出力を表示します。

このコマンドが戻す情報は、動的な状況を反映しています。DB2 が情報を表示するまでに、状況が変化している場合があります。

出力例: DISPLAY FUNCTION SPECIFIC コマンドは、次の出力を生成します。

DSNX975I = DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT FOLLOWS -

------- SCHEMA=PAYROLLFUNCTION STATUS ACTIVE QUED MAXQ TIME FAIL WLM_ENVAPPL1 STARTED 1 0 0 0 0 PAYROLLAPPL2 STARTED 1 0 0 0 1 PAYROLLAPPL3 STARTED 0 1 2 0 0 PAYROLLAPPL5 STOPREJ 0 0 0 0 0 SANDBOXAPPL6 STOPABN 0 0 0 0 1 PAYROLLFUNC1 STOPQUE 0 0 0 0 0 SANDBOX

DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT COMPLETEDSN9022I = DSNX9COM ’-DISPLAY FUNC’ NORMAL COMPLETION

DISPLAY FUNCTION SPECIFIC コマンド出力: DISPLAY FUNCTION SPECIFIC

コマンドは、次の出力を表示します。

FUNCTION 関数の特定名。

STATUS 関数の状況。可能な値には、以下のものがあります。

STARTED 関数に対する要求を処理できます。

STOPQUE 要求は待ち行列に入れられています。

STOPREJ 要求はリジェクトされています。

STOPABN 要求は異常終了のためリジェクトされています。

ACTIVE 関数を現在実行しているスレッドの数。

QUED 関数がスケジュールされるのを待機しているスレッドの数。

MAXQ DB2 サブシステムの開始以後、関数がスケジュールされるのを同時に待機したスレッドの最大数。

TIME 関数への要求がスケジュールされるのを待っている間に、 SQL ステートメントがタイムアウトになった回数。

FAIL プロシージャーが失敗した回数。DB2 は、START FUNCTION コマンドが実行されるたびに、この値を 0 にリセットします。


第 24 章 -DISPLAY FUNCTION SPECIFIC (DB2) 167

|||||||||||||

|

|

|

WLM_ENV 関数が実行される WLM 環境。

メッセージ DSNX971I は、STOP FUNCTION SPECIFIC コマンドにパターン・マッチング文字 (*) を指定した部分的な名前が含まれていたために、停止した関数の範囲をリストします。詳しくは、 437ページの『第 78 章 -STOP FUNCTION

SPECIFIC (DB2)』を参照してください。

例例 1: PAYROLL スキーマと HRPROD スキーマ内の関数の情報を表示します。

-DISPLAY FUNCTION SPECIFIC(PAYROLL.*, HRPROD.*)


DSNX975I = DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT FOLLOWS-

------ SCHEMA=PAYROLLFUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENVPAYRFNC1 STARTED 0 0 1 0 0 WLMENV1PAYRFNC2 STOPQUE 0 5 5 3 0 WLMENV1PAYRFNC3 STARTED 2 0 6 0 0 WLMENV1USERFNC4 STOPREJ 0 0 1 0 0 WLMENV3

------ SCHEMA=HRPRODFUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENVHRFNC1 STARTED 0 0 1 0 0 WLMENV2HRFNC2 STOPREJ 0 0 1 0 0 WLMENV2DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT COMPLETEDSN9022I = DSNX9COM ’-DISPLAY FUNC’ NORMAL COMPLETION

例 2: PAYROLL スキーマ内の特定の関数についての情報を表示します。

-DISPLAY FUNCTION SPECIFIC(PAYROLL.USERFNC2,PAYROLL.USERFNC4)



------ SCHEMA=PAYROLLFUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENVUSERFNC2 STOPQUE 0 5 5 3 0 WLMENV3USERFNC4 STOPREJ 0 0 1 0 0 WLMENV3DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT COMPLETEDSN9022I = DSNX9COM ’-DISPLAY FUNC’ NORMAL COMPLETION

例 3: DB2 アプリケーションがアクセスした SYSADM スキーマ内のすべての関数についての情報を表示します。次のコマンドを入力する時点で、STOP FUNCTION

SPECIFIC(SYSADM.FN*) ACTION(QUEUE) コマンドが有効な状態にあると仮定します。

-DISPLAY FUNCTION SPECIFIC(SYSADM.*)



------ SCHEMA=SYSADMFUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENVFNC1 STOPQUE 0 0 0 0 0 WLMENV1FNC2 STOPQUE 0 0 0 0 0 WLMENV3



DSNX9DIS FUNCTIONS FN - FN* STOP QUEUEDSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT COMPLETEDSN9022I = DSNX9COM ’-DISPLAY FUNC’ NORMAL COMPLETION


第 24 章 -DISPLAY FUNCTION SPECIFIC (DB2) 169

第 25 章 -DISPLAY GROUP (DB2)

DB2 コマンド DISPLAY GROUP は、DB2 サブシステムが属するデータ共用グループについての情報を表示します。DISPLAY GROUP DETAIL は、DB2 サブシステムおよびグループ・モード (互換モード、新機能有効モード、または DB2 バージョン 8 新機能モード以降) を表示します。

省略形: -DIS GROUP


v 『環境』

v 『許可』

v 『構文』









構文

�� DISPLAY GROUPDETAIL

��


オプションの説明DETAIL並列処理コーディネーターと並列処理アシスタントに関する情報を表示します。DB2 データ共用グループが新機能有効モードの場合、DISPLAY GROUP

DETAIL は、カタログおよびディレクトリー表スペースとその状況をリストします。

使用上の注意メンバーの状況: メッセージ DSN7106I には、メンバーの XCF 状況についての情報が含まれています (表示出力の STATUS)。状況は ACTIVE、QUIESCED、またはFAILED のいずれかです。

ACTIVE は DB2 サブシステムが活動中であることを示し、FAILED はそれに障害があることを示します。また、QUIESCED 状況は STOP DB2 コマンドの結果として生じるもので、いくつかのサブカテゴリーからなります。

QUIESCED正常に STOP DB2 コマンドが実行された結果として、正常な静止状態を示します。

Q Q (静止) は次のうちの 1 つ以上の文字と組み合わされていることがあります。

I 未確定または延期された異常終了のリカバリー単位 (UR) が未解決です。つまり、保持ロックが保留状態です。

C キャストアウト・エラーが発生しました。ページ・セットまたはパーティションを最後に更新したプログラムは、そのページ・セットまたはパーティションをカップリング・ファシリティーからディスクへ書き込めませんでした。

DB2 を再始動する前に、カップリング・ファシリティーと処理プログラムとの間に接続性の問題がないことを確認してください。

R DB2 が 1 つ以上のリモート・ロケーションとの再同期を実行するには、保持された情報が必要となります。

DB2 の再始動時に、この再同期が実行されます。

ACTIVE無条件で正常なアクティブ状態を示します。

A メンバーはアクティブですが、無条件ではありません。A (アクティブ)

は、次の文字と対になっている場合があります。

I 未確定または延期された異常終了のリカバリー単位 (UR) が未解決です。保持ロックが保留状態であることを示しています。

非データ共用環境におけるこのコマンドの使用: DB2 から発行される応答は、グループ名、メンバー名、およびメンバー ID に関する情報 (これは存在しない) を除き、同じです。

-DISPLAY GROUP (DB2)


出力DISPLAY GROUP コマンド出力: DISPLAY GROUP コマンドでは、次の出力を表示します。

*** BEGIN

DB2 グループの名前

DB2 MEMBER

DB2 グループ・メンバー名

ID DB2 グループ・メンバー ID

SUBSYS

DB2 グループ・メンバーのサブシステム名

CMDPREF

各メンバーのコマンド接頭部

STATUS

各メンバーの状況 (ACTIVE、追加の条件が示された、あるいは示されないQUIESCED、および FAILED)

SYSTEM NAME

メンバーが実行中の z/OS システム名、またはそのメンバーの状況がQUIESCED または FAILED である場合はそのメンバーが最後に実行していた z/OS システム名

LVL 3 桁の数字ストリングで、おのおのが以下の情報を意味する。v DB2 バージョンv DB2 リリースv DB2 修正レベル

IRLM SUBSYS

DB2 メンバーの接続先である IRLM サブシステムの名前

IRLMPROC

接続された IRLM のプロシージャー名

SCA SCA 構造のサイズ (KB 単位)、および現在使用中のパーセント。

LOCK1

LOCK1 構造のサイズ (KB 単位)。

さらに以下のロック情報も表示されます。

v ロック表で可能なロック・エントリーの最大数、およびそれらのロック・エントリーのうち現在使用中の数。なお、この数は近似値です。

v 変更ロック・リスト・エントリーの最大数、およびそれらのリスト・エントリーのうち現在使用中の数。

ロック表および変更ロックのリストについて詳しくは、「DB2 データ共用:

計画および管理」第 6 章を参照してください。

PARALLELISM COORDINATOR

この DB2 メンバーが並列処理を調整できるかどうかを示します。

PARALLELISM ASSISTANT

この DB2 メンバーが並列処理を補助できるかどうかを示します。


第 25 章 -DISPLAY GROUP (DB2) 173

出力結果が、ロック構造または SCA のいずれかが 0% 使用中であることを示している場合、それはその構造が空であることを意味していません。これは、その構造が非常に大きく、SCA で保持されているロックの数、または SCA にあるレコードの数が 1% に満たないことを意味している可能性があります。

メッセージ DSN7101I の説明:

GROUP

データ共用グループの名前

GROUP LEVEL

3 桁の数字ストリングで、おのおのが以下の情報を意味する。v DB2 バージョンv DB2 リリースv DB2 修正レベル

上記 DB2 リリースの部分には、データ共用グループ内の開始済み DB2 サブシステムの中の、最も高いリリースが表示されます。

MODE 以下のように、カタログ・モードを示します。

v C は互換モードを示します。

v E は新機能有効モードを示します。

v N は DB2 バージョン 8 新機能モード以降を示します。

MODE は、DETAIL オプション指定時にのみ表示されます。

PROTOCOL LEVEL

この値は、保守容易性のためにのみ提供されています。

例例 1: 以下の DISPLAY GROUP コマンドを使用すると、データ共用グループに対する以下の出力例を生成できます。

-DB1A DISPLAY GROUP

例 2: 以下の DISPLAY GROUP コマンドを使用すると、非データ共用環境で以下の出力例が生成されます。

DSN7100I -DB1A DSN7GCMD*** BEGIN DISPLAY OF GROUP(DSNDB10 ) GROUP LEVEL(710)

PROTOCOL LEVEL(2) GROUP ATTACH NAME(DB10)--------------------------------------------------------------------DB2 DB2 SYSTEM IRLMMEMBER ID SUBSYS CMDPREF STATUS LVL NAME SUBSYS IRLMPROC-------- --- ---- -------- -------- --- -------- ---- --------DB1A 1 DB1A -DB1A ACTIVE 810 MVSA DJ1A DB1AIRLMDB1B 2 DB1B -DB1B ACTIVE 810 MVSB DJ1B DB1BIRLMDB1C 3 DB1C -DB1C ACTIVE 810 MVSC DJ1C DB1CIRLMDB1D 4 DB1D -DB1D FAILED 710 MVSD DJ1D DB1DIRLMDB1E 5 DB1E -DB1E QUIESCED 710 MVSE DJ1E DB1EIRLMDB1F 6 DB1F -DB1F ACTIVE 810 MVSF DJ1F DB1FIRLMDB1G 7 DB1G -DB1G ACTIVE 810 MVSG DJ1G DB1GIRLM--------------------------------------------------------------------SCA STRUCTURE SIZE: 1024 KB, STATUS= AC, SCA IN USE: 11 %LOCK1 STRUCTURE SIZE: 1536 KBNUMBER LOCK ENTRIES: 262144NUMBER LIST ENTRIES: 7353, LIST ENTRIES IN USE: 0*** END DISPLAY OF GROUP(DSNDB10 )DSN9022I -DB1A DSN7GCMD ’DISPLAY GROUP ’ NORMAL COMPLETION



||

|

|

|

|

|

|

-DB1A DISPLAY GROUP

例 3: DETAIL オプションを指定した DISPLAY GROUP 使用すれば、以下の例に示されているようなデータ共用グループについてのさらに詳しい情報を入手することができます。

-DB1A DISPLAY GROUP DETAIL

DSN7100I -DB1A DSN7GCMD*** BEGIN DISPLAY OF GROUP(.......) GROUP LEVEL(...)

PROTOCOL LEVEL(...) GROUP ATTACH NAME(....)--------------------------------------------------------------------DB2 DB2 SYSTEM IRLMMEMBER ID SUBSYS CMDPREF STATUS LVL NAME SUBSYS IRLMPROC-------- --- ---- -------- -------- --- -------- ---- --------........ 0 DB1A -DB1A ACTIVE 710 MVSA DJ1A DB1AIRLM--------------------------------------------------------------------*** END DISPLAY OF GROUP(DSNDB10)DSN9022I -DB1A DSN7GCMD ’DISPLAY GROUP ’ NORMAL COMPLETION


第 25 章 -DISPLAY GROUP (DB2) 175

DSN7100I -DB1A DSN7GCMD*** BEGIN DISPLAY OF GROUP(DSNCAT1) GROUPLEVEL(810) MODE(E)

PROTOCOL LEVEL(2) GROUP ATTACH NAME(CAT1)--------------------------------------------------------------------DB2 SYSTEM IRLMMEMBER ID SUBSYS CMDPREF STATUS NAME LVL SUBSYS IRLMPROC-------- --- ---- -------- -------- -------- --- ---- --------DB1A 1 DB1A -DB1A ACTIVE MVSA 810 AR21 ARLM21DB1B 2 DB1B -DB1B ACTIVE MVSB 810 BR21 BRLM21DB1C 3 DB1C -DB1C ACTIVE MVSC 810 CRLM CRLM21DB2D 4 DB2D -DB2D FAILED MVSD 810 DR21 DRLM21DB2E 5 DB2E -DB2E QUIESCED MVSE 810 ER21 ERLM21DB2F 6 DB2F -DB2F ACTIVE MVSF 810 FR21 FRLM21DB2G 7 DB2G -DB2G ACTIVE MVSG 810 GR21 GRLM21--------------------------------------------------------------------DB2 PARALLEL PARALLELMEMBER COORDINATOR ASSISTANT-------- ----------- ---------DB2A YES NODB2B YES YESDB2B YES YESDB1C **** ****DB2D **** ****DB2E **** ****DB2F NO YESDB2G NO NO--------------------------------------------------------------------TABLE ENABLED FORSPACE NEW FUNCTION-------- ------------SPTR YESSYSDBASE YESSYSDBAUT YESSYSDDF YESSYSGPAUT YESSYSGROUP YESSYSGRTNS YESSYSHIST YESSYSJAVA YESSYSOBJ NOSYSPKAGE NOSYSPLANP NOSYSSEQ NOSYSSEQ2 NOSYSSTATS NOSYSSTR NOSYSUSER NOSYSVIEWS NO--------------------------------------------------------------------

SCA STRUCTURE SIZE: 1024 KB, STATUS= AC, SCA IN USE: 11 %LOCK1 STRUCTURE SIZE: 1536 KB, LOCK1 IN USE: < 1 %NUMBER LOCK ENTRIES: 262144, LOCK ENTRIES IN USE: 33NUMBER LIST ENTRIES: 7353, LIST ENTRIES IN USE: 0*** END DISPLAY OF GROUP(DSNCAT )DSN9022I -DB1A DSN7GCMD ’DISPLAY GROUP ’ NORMAL COMPLETION


|

||||||||||||||||||||||

第 26 章 -DISPLAY GROUPBUFFERPOOL (DB2)

DB2 コマンド DISPLAY GROUPBUFFERPOOL は、DB2 グループ・バッファー・プールの状況についての情報を表示します。さらに、関連のある統計も表示します。

省略形: -DIS GBPOOL


v 『環境』

v 『許可』










構文

�� DISPLAY GROUPBUFFERPOOL

�

*,

( gbpname )structure-name

�

�*

TYPE( GCONN )MCONNNOCACHE

MDETAILINTERVAL

( )*

�

�GDETAIL

INTERVAL( )

*

NOCONNLIST( YES )

��

オプションの説明(*) すべてのグループ・バッファー・プールについてグループ・バッファー・プールの状況を表示します。

(gbpname)状況を表示させるグループ・バッファー・プールの名前を指定します。v 4 KB グループ・バッファー・プールは、GBP0、GBP1、...、GBP49 と名前を指定します。

v 8 KB グループ・バッファー・プールは、GBP8K0、GBP8K1、 ...、GBP8K9

と名前を指定します。v 16 KB グループ・バッファー・プールは、GBP16K0、GBP16K1、...、

GBP16K9 と名前を指定します。v 32 KB グループ・バッファー・プールには、GBP32K、GBP32K1、...、

GBP32K9 と名前を指定します。

(structure-name)グループ・バッファー・プールに対して裏に存在するカップリング・ファシリティー構造に名前を指定します。カップリング・ファシリティー構造の名前は、次のような形式になっています。

groupname_gbpname

groupname は DB2 データ共用グループ名であり、下線 (_) によってgroupname と gbpname が区切られています。

TYPE指定されたグループ・バッファー・プールの中で、情報を表示するグループ・バッファー・プールのタイプを示します。

-DISPLAY GROUPBUFFERPOOL (DB2)


(*) すべてのグループ・バッファー・プールが指定されます。これはデフォルトです。

(GCONN)データ共用グループのいずれかのメンバーに現在接続中のグループ・バッファー・プール。接続は「アクティブ」または「失敗 - 持続中」のいずれでも可能です。

(MCONN)コマンドの対象となっているメンバーに現在接続中のグループ・バッファー・プール。

(NOCACHE)GBPCACHE 属性が NO にセットされているグループ・バッファー・プール。

MDETAIL指定したグループ・バッファー・プールについての統計的な詳細報告書を表示して、そこにグループ・バッファー・プールごとのメンバーの活動を反映させます。コマンドの対象となったメンバーが一度もアクティブでグループ・バッファー・プールに接続したことがなければ、詳細報告書は表示されません。

(INTERVAL)増分統計を表示します。そのメンバーについての MDETAIL(INTERVAL) 報告書が以前に作成されていれば、最後の MDETAIL(INTERVAL) 報告書以降の累積した値が表示されます。これはデフォルトです。

(*) 累積統計を表示します。表示される値は、このメンバーがグループ・バッファー・プールに最初に接続した時以降を累積したものです。

GDETAIL指定したグループ・バッファー・プールについての統計的な詳細報告書を表示して、そこにグループ・バッファー・プールごとのグループ全体の活動を反映させます。コマンドの対象となったメンバーがアクティブでグループ・バッファー・プールに接続されていなければ、詳細報告書は表示されません。

(INTERVAL)増分統計を表示します。そのメンバーについての GDETAIL(INTERVAL) 報告書が以前に作成されていれば、最後の GDETAIL(INTERVAL) 報告書以降の累積した値が表示されます。これはデフォルトです。

(*) 累積統計を表示します。表示される値は、そのグループ・バッファー・プールが最後に割り振りまたは再割り振りされた時以降を累積したものです。

CONNLIST指定したグループ・バッファー・プールについての接続リスト報告書を表示して、そのグループ・バッファー・プールに現在接続しているサブシステムの接続名、およびそれらの接続状況をリスト表示するかどうかを指定します。

(NO)接続リスト報告書を表示しません。

(YES)接続リスト報告書を表示します。


第 26 章 -DISPLAY GROUPBUFFERPOOL (DB2) 179

出力DISPLAY GROUPBUFFERPOOL コマンドを使って、以下の 3 つの報告書タイプを作成可能です。v 要約報告書v グループ詳細報告書v メンバー詳細報告書

要約報告書グループ・バッファー・プールについて、要約情報を表示させることができます。この要約報告書には、お客様が情報を要求とするグループ・バッファー・プールにこの DB2 サブシステムがアクティブに接続されているかどうかが表示されます。この要約報告書には次のような情報も含まれます。

グループ・バッファー・プールの特性:v しきい値v ディレクトリー - データ項目比率 (ペンディングと現行の両方)

v チェックポイント間隔v リカバリー状況 (損害評価がペンディングになっているか)

グループ・バッファー・プールについての CFRM ポリシー情報:

v CFRM ポリシーに指定されている割り振り値と、そのグループ・バッファー・プールが現時点でカップリング・ファシリティーにおいて割り振られているかどうか

v 実際の割り当てサイズ (CFRM ポリシーに指定されたものとは異なることがある)

と揮発性の状況。DB2 は不揮発性ストレージを要求しますが、揮発構造にそれを割り当てることも可能です。

v ディレクトリー項目、データ・ページ、およびグループ・バッファー・プールへの接続の実際の個数。

この要約報告書には、次のように補足情報が含まれています。

AUTOMATIC RECOVERYこのグループ・バッファー・プールについて自動リカバリー処理が可能かどうかを示します。

DUPLEXアクティブ CFRM ポリシーに指定されたグループ・バッファー・プールの現行の二重化オプションを示します。

REBUILD STATUSこのグループ・バッファー・プールについて再作成処理が実行中かどうかを示します。実行中の場合は、再作成のフェーズが、QUIESCE、CONNECT、または CLEANUP として示されます。再作成が現在停止処理中の場合は、状況は STOPPING と示されます。

DUPLEXING STATUS二重化に関して、グループ・バッファー・プールの現在の状態を示します。

CFNAMEグループ・バッファー・プールが割り振られているカップリング・ファシリ



|

|

ティーの名前を示します。グループ・バッファー・プールが二重化されている場合、これは 1 次グループ・バッファー・プールに関連付けられたカップリング・ファシリティー名です。

CFLEVELグループ・バッファー・プールが割り振られているカップリング・ファシリティーのレベルを示します。グループ・バッファー・プールが二重化されている場合、これは 1 次グループ・バッファー・プールに関連付けられたカップリング・ファシリティー・レベルです。

カップリング・ファシリティーの操作可能レベル (「OPERATIONAL

LEVEL」) と実使用レベル (「ACTUAL LEVEL」)の両方が示されます。操作可能レベルには、この DB2 サブシステムから見たカップリング・ファシリティーの使用可能レベルが表示されます。実使用レベルは、z/OS D CF

コマンドによって表示されるレベルです。

LAST GROUP BUFFER POOL CHECKPOINT最後のグループ・バッファー・プール・チェックポイントの日付/時刻、そのチェックポイントで記録された LRSN、およびグループ・バッファー・プール構造所有者のメンバー名を示します。

グループ詳細報告書グループ詳細報告書には、指定されたグループ・バッファー・プールのグループ全体における活動を反映した詳細な統計情報が示されます。この統計情報は、グループ・バッファー・プールのサイズや他の特性をチューニングするにあたって役に立ちます。この情報の使用法について詳しくは、「DB2 データ共用: 計画および管理」第 6 章を参照してください。グループ詳細報告書には、以下の情報のほかに、要約報告書と同じ情報も含まれています。

READS読み取りについての情報。

これは、グループ・バッファー・プールに対する読み取り数の詳細な計算結果であり、以下の情報が含まれています。v データが戻された読み取りの数。v データが戻されなかった読み取り回数。この情報には、ページがカップリング・ファシリティー内のキャッシュに格納されたかどうか、およびデータへの要求を満たすためにディレクトリー項目を作成する必要があったかどうかについて、詳細な情報が含まれます。

WRITES書き込みについての情報。

これには、未使用ページと変更ページへの書き込みの数、およびグループ・バッファー・プールにおける記憶域の不足が原因で失敗した書き込みの数が組み込まれます。

CHANGED PAGES SNAPSHOT VALUE現時点でグループ・バッファー・プールにある変更ページの数 (スナップショット値)。

RECLAIMSディレクトリー項目とデータ・ページのレクラメーションの数。



|

|

|

|

|

|

|

|

|

|

|

|

|

CASTOUTSキャストアウトの数。

CROSS INVALIDATIONSディレクトリーのレクラメーション、および書き込みが原因で生じた、相互無効化の数。

DUPLEXING STATISTICS FOR GBPn

出力のこの部分は、二重化の詳細な統計を次のように示します。

CHANGED PAGES

2 次グループ・バッファー・プールに書き込まれる変更ページの数を示します。レポート作成のインターバル全般にわたってグループ・バッファー・プールが二重化されていた場合、この数値はメッセージ DSNB786I で 1 次グループ・バッファー・プールについて報告される CHANGED PAGES カウンターの近似値です。表示用のカウンター情報を集めるタイミングや、直前に発生した可能性があるトランザクション障害が原因で、必ずしも表示されたカウントが実際のカウントと厳密に同じにはならない場合があります。

FAILED DUE TO LACK OF STORAGE

記憶域不足により失敗した、2 次グループ・バッファー・プールへの書き込みの回数を示します。

CHANGED PAGES SNAPSHOT VALUE

現在 2 次グループ・バッファー・プールにキャッシュされている変更ページの数を示します。この数値は 1 次グループ・バッファー・プールの CHANGED PAGES SNAPSHOT VALUE の近似値ですが、おそらく同じ値ではありません。その理由は、2 つの異なるカップリング・ファシリティー構造に対して非同期に統計を収集するということに起因します。

メンバー詳細報告書メンバー詳細報告書には要約報告書と共に特定のメンバーのシステムが現行環境にどのように応答しているかといった追加の情報が組み込まれます。この報告書では、読み取りと書き込みが同期のものと非同期のものとに分類されます。同期の読み取りまたは書き込み数が多いときは、グループ・バッファー・プールの調整が必要なことを示している場合があります。

GBP CHECKPOINTS TRIGGEREDこのグループ・バッファー・プールについて発生したチェックポイント数。

PARTICIPATION IN REBUILDこのメンバーがこのグループ・バッファー・プールの再作成に使用された回数。

CASTOUTS出力のこの部分は、キャストアウト処理の詳細な統計情報を次のように示します。

PAGES CAST OUT

このメンバーによりグループ・バッファー・プールからキャストアウトされたデータ・ページ数を示します。



UNLOCK CASTOUT

完了したキャストアウト入出力のために DB2 がカップリング・ファシリティーに対しアンロック要求を発行した回数。ページがディスクへキャストアウトされると、カップリング・ファシリティーでそれらのページは「キャストアウト用にロック」されます。キャストアウト・ロックは、特定のページについて、1 つのシステムだけがキャストアウトを行えるようにするためのものです。

通常、DB2 ではキャストアウトのためのディスクへの書き込み入出力要求に複数のページを組み込みます。したがって、UNLOCK

CASTOUT カウンターには、常に PAGES CASTOUT カウンターの値以下の値が入ることになり、そのため、1 回の入出力で複数ページが書き込まれる場合は、このカウンターの値は極端に少なくなるはずです。例えば、平均でキャストアウト書き込み入出力ごとにfour ページが書き込まれる場合は、PAGES CASTOUT の値はUNLOCK CASTOUT の 4 倍になるはずです。

READ CASTOUT CLASS

特定のページ・セットまたはパーティションに属しているページのうちどのページを変更ページとしてグループ・バッファー・プールへキャッシュしてキャストアウトしなければならないかを判別するためにグループ・バッファー・プールへ出された要求の数。

READ CASTOUT CLASS は、ページ・セットまたはパーティション・キャストアウトの所有者により出されますが、GBPOOLT しきい値に達した時点ではグループ・バッファー・プール構造の所有者によっても出されます。

READ CASTOUT STATISTICS

GBPOOLT しきい値に達したときに、グループ・バッファー・プール構造所有者により出される要求の数。これにより、どのキャストアウト・クラスがページを変更したかが分かります。通常は、READ CASTOUT STATISTICS は GBPOOLT しきい値に達するたびに 1 度または 2 度だけ出されます。

READ DIRECTORY INFO

グループ・バッファー・プール内のすべての変更ページのディレクトリー項目に対する読み取り要求の数。グループ・バッファー・プール構造所有者は、こうした読み取り要求をグループ・バッファー・プールのチェックポイントで出します。この要求の目的は、グループ・バッファー・プールに障害が起きた場合に使用する最も古いリカバリー LRSN を判断することです。このリカバリー LRSN

はメッセージ DSNB798I に表示されます。

ディレクトリー情報の読み取り要求は、各グループ・バッファー・プールのチェックポイントごとに数回出される場合があります。ここで極端に大きな数値が表示される場合は、カップリング・ファシリティーのモデルごとに異なるタイムアウト基準によって読み取り要求が短縮されている可能性があります。この問題を緩和するためには、これらのカップリング・ファシリティーを CFLEVEL=2 以上にアップグレードしてください。



OTHER INTERACTIONS出力のこの部分では、この DB2 と当該グループ・バッファー・プール間でのその他の対話の詳細がリストされます。

REGISTER PAGE

DB2 が単一ページについてグループ・バッファー・プールにインタレストを登録した回数。この回数は登録のみの要求数です。つまり、このページに対してグループ・バッファー・プール内に何もデータをキャッシュ化しないため、そのページに対してはどのようなデータも戻されることを DB2 は要求しようとしません。REGISTER PAGE 要求は、ページ・セットまたはパーティションに関する P ロックを S モードから IS モードへ、または SIX モードから IX モードへダウングレードするときにモード間無効検査を実施する目的でページにディレクトリー項目を作成するためにだけ出されます。

UNREGISTER PAGE

DB2 が、単一ページについてグループ・バッファー・プールに登録したインタレストを破棄した回数。この破棄が行われるのは、通常、グループ・バッファー・プール従属のパーティションまたはページ・セットに属するローカル・バッファー・プールからのページを DB2 が使用するときです。

DELETE NAME

DB2 がグループ・バッファー・プールに対し、特定のページ・セットまたはパーティションに関連付けられたディレクトリー・エントリーとデータ・エントリーの削除要求を発行した回数。DB2 はこの要求を以下の時点で発行します。

v ページ・セットまたはパーティションをグループ・バッファー・プール従属から非グループ・バッファー・プール従属へ変換するとき。

v 最初の DB2 メンバーが、GBPCACHE ALL オブジェクト用のオブジェクトをオープンするとき。

READ STORAGE STATS

DB2 がグループ・バッファー・プールに統計情報を要求した回数。この回数は比較的小さくなります。この統計情報は、グループ・バッファー・プール構造の所有者によるグループ・バッファー・プール・チェックポイントごとに 1 回発行されます。また、この統計情報は、DISPLAY GROUPBUFFERPOOL GDETAIL 要求に対しても発行され、IFCID 0254 を記録します。

DUPLEXING STATISTICS FOR GBP0-SEC出力のこの部分では、この DB2 と当該グループ・バッファー・プール間でのその他の対話の詳細がリストされます。

CHANGED PAGES

2 次グループ・バッファー・プールに書き込まれた変更ページの数を示します。この数値は、1 次グループ・バッファー・プールへの変更ページの同期書き込みと 1 次グループ・バッファー・プールへの変更ページの非同期書き込みの合計の近似値となります。表示用



のカウンター情報を集めるタイミングや、直前に発生した可能性があるトランザクション障害が原因で、必ずしも表示されたカウントが実際のカウントと厳密に同じにはならない場合があります。

FAILED DUE TO LACK OF STORAGE

記憶域不足により失敗した、2 次グループ・バッファー・プールへの書き込みの回数を示します。

COMPLETION CHECKS SUSPENDED

2 次グループ・バッファー・プールへの変更ページの書き込みの完了を DB2 が検査したが、書き込みがまだ完了していなかった回数を示します。DB2 では、2 次グループ・バッファー・プールへの書き込みが完了するまで、実行ユニットを一時中断します。

DELETE NAME LIST1 次グループ・バッファー・プールからディスクにキャストアウトされたばかりのページのセットを 2 次グループ・バッファー・プールから削除する、DELETE NAME LIST 要求回数を示します。

READ CASTOUT STATISTICS2 次グループ・バッファー・プール内の孤立データのエントリーを検査するための READ CASTOUT STATISTICS 要求回数を示します。グループ・バッファー・プール構造所有者である DB2 メンバーは、この要求を定期的に発行し、不要情報の収集が必要であるかどうかを判断します。

DELETE NAME2 次グループ・バッファー・プールから孤立データのエントリーを削除するDELETE NAME 要求回数を示します。グループ・バッファー・プール構造の所有者である DB2 メンバーは、不要情報の収集が必要であると判断すると、これらの要求を発行します。

例例 1: この例は、次のコマンドにより作成することができる要約報告書の例です。

-DISPLAY GROUPBUFFERPOOL(GBP29)

グループ・バッファー・プールが二重化されており、2 次グループ・バッファー・プールが現在割り振られていると、メッセージ DSNB799I が表示されます。2 次グループ・バッファー・プールが割り振られていないと、メッセージ DSNB799I は出力に含まれません。



例 2: グループ・バッファー・プール 29 (GBP29) に関して、そのグループ・バッファー・プールへのすべての接続を含め、要約報告書が必要であると想定します。以下のコマンドを入力します。

-DISPLAY GROUPBUFFERPOOL(GBP29) CONNLIST(YES)


DSNB750I - DISPLAY FOR GROUP BUFFER POOL GBP29 FOLLOWSDSNB755I - DB2 GROUP BUFFER POOL STATUS

CONNECTED = YESCURRENT DIRECTORY TO DATA RATIO = 5PENDING DIRECTORY TO DATA RATIO = 5CURRENT GBPCACHE ATTRIBUTE = YESPENDING GBPCACHE ATTRIBUTE = YES

DSNB756I - CLASS CASTOUT THRESHOLD = 10%GROUP BUFFER POOL CASTOUT THRESHOLD = 50%GROUP BUFFER POOL CHECKPOINT INTERVAL = 8 MINUTESRECOVERY STATUS = NORMALAUTOMATIC RECOVERY = Y

DSNB757I - MVS CFRM POLICY STATUS FOR DSNCAT_GBP29 = NORMALMAX SIZE INDICATED IN POLICY = 2048 KBDUPLEX INDICATOR IN POLICY = ENABLEDCURRENT DUPLEXING MODE = DUPLEXALLOCATED = YES

DSNB758I - ALLOCATED SIZE = 2048 KBVOLATILITY STATUS = VOLATILEREBUILD STATUS = DUPLEXEDCFNAME = CACHE01OPERATIONAL CFLEVEL = 5ACTUAL CFLEVEL = 7

DSNB759I - NUMBER OF DIRECTORY ENTRIES = 1950NUMBER OF DATA PAGES = 389NUMBER OF CONNECTIONS = 2

DSNB798I - LAST GROUP BUFFER POOL CHECKPOINT17:08:41 OCT 16, 2002

GBP CHECKPOINT RECOVERY LRSN = AF6BBAEF3307STRUCTURE OWNER = V61B

DSNB799I - SECONDARY GBP ATTRIBUTESALLOCATED SIZE = 2048 KBVOLATILITY STATUS = VOLATILECFNAME = LF01OPERATIONAL CFLEVEL = 5ACTUAL CFLEVEL = 7NUMBER OF DIRECTORY ENTRIES = 1950NUMBER OF DATA PAGES = 389

DSNB790I - DISPLAY FOR GROUP BUFFER POOL GBP29 IS COMPLETEDSN9022I - DSNB1CMD ’-DISPLAY GBPOOL’ NORMAL COMPLETION



例 3: この例は、次のコマンドで作成されるグループ詳細報告書を示しています。

-DISPLAY GROUPBUFFERPOOL(GBP29) GDETAIL(*)

2 次グループ・バッファー・プールが割り振られている場合にのみ、メッセージDSNB762I が出力に表示されます。




DSNB757I - MVS CFRM POLICY STATUS FOR DSNCAT_GBP29 = NORMALMAX SIZE INDICATED IN POLICY = 2048 KBDUPLEX INDICATOR IN POLICY = ENABLEDCURRENT DUPLEXING MODE = SIMPLEXALLOCATED = YES






DSNB766I - THE CONNLIST REPORT FOLLOWSDSNB767I - CONNECTION NAME = DB2_V61B , CONNECTION STATUS = D

CONNECTOR’S RELEASE = 6100DSNB767I - CONNECTION NAME = DB2_V61A , CONNECTION STATUS = D

CONNECTOR’S RELEASE = 6100DSNB769I - THE CONNLIST REPORT IS COMPLETEDSNB790I - DISPLAY FOR GROUP BUFFER POOL GBP29 IS COMPLETEDSN9022I - DSNB1CMD ’-DISPLAY GBPOOL’ NORMAL COMPLETION



例 4: この例は、次のコマンドで作成される報告書のメンバー明細部分を示しています。










DSNB783I - CUMULATIVE GROUP DETAIL STATISTICS SINCE 17:08:35 OCT 16,2002DSNB784I - GROUP DETAIL STATISTICS

READSDATA RETURNED = 4

DSNB785I - DATA NOT RETURNEDDIRECTORY ENTRY EXISTED = 0DIRECTORY ENTRY CREATED = 45DIRECTORY ENTRY NOT CREATED = 0, 0

DSNB786I - WRITESCHANGED PAGES = 5CLEAN PAGES = 0FAILED DUE TO LACK OF STORAGE = 0

CHANGED PAGES SNAPSHOT VALUE = 5DSNB787I - RECLAIMS

FOR DIRECTORY ENTRIES = 0FOR DATA ENTRIES = 0

CASTOUTS = 0

DSNB788I - CROSS INVALIDATIONSDUE TO DIRECTORY RECLAIMS = 0DUE TO WRITES = 0EXPLICIT = 0

DSNB762I - DUPLEXING STATISTICS FOR GBP29-SECWRITESCHANGED PAGES = 5FAILED DUE TO LACK OF STORAGE = 0

CHANGED PAGES SNAPSHOT VALUE = 5DSNB790I - DISPLAY FOR GROUP BUFFER POOL GBP29 IS COMPLETEDSN9022I - DSNB1CMD ’-DISPLAY GBPOOL’ NORMAL COMPLETION



-DISPLAY GROUPBUFFERPOOL(GBP29) MDETAIL(*)

メッセージ DSNB764I および DSNB793I は、2 次グループ・バッファー・プールが割り振られている場合にのみ、出力に表示されます。










DSNB772I - CUMULATIVE MEMBER DETAIL STATISTICS SINCE 17:08:41 OCT 16,2002DSNB773I - MEMBER DETAIL STATISTICS

SYNCHRONOUS READSDUE TO BUFFER INVALIDATIONDATA RETURNED = 0DATA NOT RETURNED = 0

DSNB774I - DUE TO DATA PAGE NOT IN BUFFER POOLDATA RETURNED = 0DATA NOT RETURNED = 0

DSNB775I - PREFETCH READSDATA NOT RETURNED = 0

DSNB789I - REGISTER PAGE LIST = 0PAGES RETRIEVED = 0

FAILED READS DUE TO LACK OF STORAGE = 0DSNB776I - SYNCHRONOUS WRITES

CHANGED PAGES = 5CLEAN PAGES = 0

DSNB777I - ASYNCHRONOUS WRITESCHANGED PAGES = 0CLEAN PAGES = 0

FAILED WRITES DUE TO LACK OF STORAGE = 0



||

DSNB778I - CASTOUT THRESHOLDS DETECTEDFOR CLASSES = 0FOR GROUP BUFFER POOL = 0

GBP CHECKPOINTS TRIGGERED = 0PARTICIPATION IN REBUILD = 1

DSNB796I - CASTOUTSPAGES CASTOUT = 0UNLOCK CASTOUT = 0READ CASTOUT CLASS = 0READ CASTOUT STATISTICS = 0READ DIRECTORY INFO = 0

DSNB797I - OTHER INTERACTIONSREGISTER PAGE = 0UNREGISTER PAGE = 0DELETE NAME = 0READ STORAGE STATISTICS = 0EXPLICIT CROSS INVALIDATIONS = 0ASYNCHRONOUS GBP REQUESTS = 0

DSNB764I - DUPLEXING STATISTICS FOR GBP29-SECWRITES

FAILED DUE TO LACK OF STORAGE = 0ASYNCHRONOUS COMPLETION CHECKS = 0

DSNB793I - DELETE NAME LIST = 0READ CASTOUT STATISTICS = 0DELETE NAME = 0OTHER ASYNCHRONOUS GBP REQUESTS = 0

DSNB790I - DISPLAY FOR GROUP BUFFER POOL GBP29 IS COMPLETEDSN9022I - DSNB1CMD ’-DISPLAY GBPOOL’ NORMAL COMPLETION


|

|

第 27 章 -DISPLAY LOCATION (DB2)

DISPLAY LOCATION コマンドは、指定されたリモート・ロケーションに関するさまざまな情報を表示します。 DETAIL オプションを指定すると、各行に続いてそのロケーションと通信している DB2 システム・スレッドが所有する会話に関連した情報が表示されます。

DISPLAY LOCATION コマンドが戻す情報は、動的状況を反映したものです。その情報が表示される時点までに、状況が変更されていることもあります。

省略形: -DIS LOC


v 『環境』

v 『許可』










構文

�� DISPLAY LOCATION

�

*,

( location-name )partial-location*<luname>ipaddr

DETAIL��

オプションの説明(*) すべてのリモート・ロケーションについての情報を表示します。

(location-name)1 つ以上のロケーション名を、コンマで区切って列挙します。

DB2 は DB2 UDB for z/OS サブシステム以外のリクエスターからロケーション名は受け取らないため、このようなリクエスターについては LUNAME または IP アドレスを入力することができます。LUNAME または IP アドレスを使用して DB2 for z/OS サブシステム以外のリクエスターを指定する方法の詳細については、<luname> および (ipaddr) オプションに関する記述を参照してください。

(partial-location*)ストリング partial-location で始まり、任意のストリング (空白ストリングを含む) で終わるすべてのロケーション名を選択します。例えば、LOCATION(ABC*) の場合には、ストリング 'ABC' で始まるロケーション名すべてが選択されます。

<luname>指定されたリモート SNA LU を介して DDF に接続されているリモート・クライアントに関する情報を要求します。この LU 名を、より小 (<) 記号とより大(>) 記号で囲んでください。例えば、DISPLAY LOCATION(<LULA>) は、LU

名が LULA であるリモート・ロケーション (DB2 UDB for z/OS でない) に関する情報を表示します。

アスタリスク (*) を使用できるのは、上述したロケーションの部分的な名前の指定方法で記載したのと同じ方法で LU 名を指定する場合です。例えば、DISPLAY LOCATION(<LULA*) の場合は、ストリング 'LULA' で始まる LU

名のすべてのリモート・ロケーション (DB2 UDB for z/OS でない) が選択されます。

(ipaddr)リモート TCP/IP ホストを介して DDF に接続されているクライアントに関する情報を要求します。IP アドレスは、nnn.nnn.nnn.nnn の形式で入力してください。DISPLAY LOCATION(124.63.51.17) は、ドット 10 進 IP アドレスが124.63.51.17 であるリモート TCP/IP ホストのクライアントに関する情報を表示します。

-DISPLAY LOCATION (DB2)


|

DETAIL例 2 に示されているように、DB2 システム・スレッドに関する会話活動の詳細情報を表示します。

出力DISPLAY LOCATION コマンドは、次の出力を表示します。

LOCATION リモート・システムの LOCATION。

PRDID リモート・システムの製品 ID (PRDID)。PRDID は nnnvvrrm の形式で表示されます。それぞれの文字は次のものを示します。nnn データベース製品vv 製品のバージョンrr 製品のリリースm 製品の修正レベル

LINKNAME リモート・システムのアドレス (LU 名または IP アドレス)。

REQUESTERSリモート・システムにアクセスしているローカル・サブシステムからのアクティブ・スレッド数。

SERVERS ローカル・サブシステムへアクセスしているリモート・システムからのスレッド数。

CONVERSATIONSパートナー・システムに関連する会話またはソケットの合計。

例例 1: 次のコマンドを使用し、スレッドおよび特定のリモート・ロケーションとの会話に関する情報を表示します。

-DISPLAY LOCATION(SAN_JOSE,SAN_FRANCISCO)

DSNL200I - DISPLAY LOCATION REPORT FOLLOWS-LOCATION PRDID LINKNAME REQUESTERS SERVERS CONVSSAN_JOSE DSN05010 LUND1 1 0 1SAN_FRANCISCO DSN05010 LUND3 1 0 1DISPLAY LOCATION REPORT COMPLETE

例 2: スレッドおよびすべてのリモート・ロケーションとの会話に関する情報を表示します。さらに、他のロケーションとの通信を行う DB2 システム・スレッドについて、詳細な会話情報を表示します。以下は、下記のコマンドが生成した出力の例です。

-DISPLAY LOCATION DETAIL

DSNL200I - DISPLAY LOCATION REPORT FOLLOWS-LOCATION PRDID LINKNAME REQUESTERS SERVERS CONVSSAN_JOSE DSN05010 LUND1 1 0 3-SYSTASK SESSID A ST TIME-SYSCON-O 00D359691359EE80 S 9128009214880-SYSCON-I 00D359691359EE81 W R 9128009214881MENLO_PARK DSN05010 LUND2 1 0 4-SYSTASK SESSID A ST TIME-SYSCON-O 00D359691359EE82 S 9128009214882-SYSCON-I 00D359691359EE83 W R 9128009214883


第 27 章 -DISPLAY LOCATION (DB2) 193

-RESYNC 00D359691359EE84 V R 9128009214884SAN_FRANCISCO DSN05010 LUND3 1 0 6-SYSTASK SESSID A ST TIME-SYSCON-O 0000000000000000 C 9128009214885-SYSCON-I 00D359691359EE86 W R 9128009214886-RESYNC 00D359691359EE87 W R 9128009214887-RESYNC 00D359691359EE88 W R 9128009214888-RESYNC 00D359691359EE89 W R 9128009214889DISPLAY LOCATION REPORT COMPLETE

例 3: 以下の DRDA パートナーに接続されている DB2 に関する情報を表示します。v TCP/IP 経由の DRDALOC という名前の非 z/OS サーバー。v DRDALOC サーバーと同じ TCP/IP ホストからのいくつかの TCP/IP クライアント。

v SNA 経由の DB2SERV という名前の DB2 for z/OS サーバー。

DISPLAY LOCATION(*)

DSNL200I - DISPLAY LOCATION REPORT FOLLOWS -LOCATION PRDID LINKNAME REQUESTERS SERVERS CONVSDRDALOC SQL03030 124.63.51.17 3 0 3124.63.51.17 SQL03030 124.63.51.17 0 15 15DB2SERV DSN05010 LULA 1 0 1DISPLAY LOCATION REPORT COMPLETE

例 4: 以下の例は、DB2 が下記の DRDA パートナーに接続されているものとします。

v DB2A は、DRDA 接続の場合は TCP/IP を使用し、DB2 プライベート・プロトコル接続の場合は SNA を使用して、この DB2 システムに接続しています。

v DB2SERV は、SNA だけを使用して DB2 に接続しています。

DISPLAY LOCATION(*)

DSNL200I - DISPLAY LOCATION REPORT FOLLOWS -LOCATION PRDID LINKNAME REQUESTERS SERVERS CONVSDB2A DSN05010 LUDB2A 3 4 9DB2A DSN05010 124.38.54.16 2 1 3DB2SERV DSN04010 LULA 1 1 3DISPLAY LOCATION REPORT COMPLETE



第 28 章 -DISPLAY LOG (DB2)

DB2 コマンド DISPLAY LOG は、オフロード・タスクのログ情報とその状況を表示します。

省略形: DIS LOG


v 『環境』

v 『許可』

v 『構文』







構文

�� DISPLAY LOG ��


使用上の注意DISPLAY LOG コマンドが提供する情報: DISPLAY LOG コマンドを使用して、現行の LOGLOAD 設定を、現在のアクティブ・ログ・データ・セットとオフロード・タスクの状況を含めて、表示することができます。ログ・データ・セットについての追加情報とチェックポイント情報は、ログ・マップ印刷ユーティリティー(DSNJU004) を使用して得ることができます。Print Log Map ユーティリティーについて詳しくは、「DB2 ユーティリティー・ガイドおよび解説書」第 3 部を参照してください。

例例 1: ログ情報とオフロード・タスクの状況を表示します。

-DISPLAY LOG


DSNJ370I - DSNJCOOA LOG DISPLAYCURRENT COPY1 LOG = DSNC810.LOGCOPY1.DS03 IS 22% FULLCURRENT COPY2 LOG = DSNC810.LOGCOPY2.DS03 IS 22% FULLH/W RBA = 0000039A9F24, LOGLOAD = 150000FULL LOGS TO OFFLOAD = 2 OF 6, OFFLOAD TASK IS (BUSY,ALLC)DSNJ371I - DB2 RESTARTED 14:06:23 MAY 22, 2002RESTART RBA 0000039A8000DSN9002I - DSNJC001 ’DIS LOG’ NORMAL COMPLETION

この例は次の情報を表示しています。

v アクティブ・ログ・データ・セットは 22% 満たされています。重複ログを作成しており、パーセントが異なる場合は、ログ・データ・セットのサイズが異なります。アクティブ・ログの 1 つがファイルの終わりに達すると、DB2 は両方のアクティブ・ログを切り替えます。このことは、片方のログ・データ・セットがもう 1 つのログ・データ・セットより大きい場合、アクティブ・ログ・スペースに未使用の部分が残ることになります。

v 現行の LOGLOAD 設定は、システム・チェックポイント間で 150000 ログ・レコードです。この値は SET LOG コマンドを使用して変更することができます。

v 6 つのアクティブ・ログ・データ・セットのうち 2 つがアーカイブを必要としています。オフロード・タスクの状況は、タスクが使用中であり、アーカイブ・ログ・データ・セットを割り振っているということを表示しています。これは、システム・コンソールに未解決のテープ・マウントが表示されている可能性があります。状況が使用中のままであり、機能しているように見えない場合は、タスクを終了し、その後 ARCHIVE LOG CANCEL OFFLOAD コマンドを使用してタスクを再始動してください。

v DB2 は、2002 年 5 月 22 日の 14 時 06 分 23 秒に開始され、RBA

0000039A8000 からログ記録を開始しました。

DISPLAY LOG (DB2)


第 29 章 -DISPLAY PROCEDURE (DB2)

DB2 コマンド DISPLAY PROCEDURE は、DB2 アプリケーションがアクセスするストアード・プロシージャーについての統計を表示します。このコマンドは、DB2

アプリケーションがアクセスしたストアード・プロシージャーごとに 1 行の出力を表示します。ストアード・プロシージャー名は、スキーマ名を付けて修飾することができます。

DISPLAY PROCEDURE コマンドが戻す情報は、動的状況を反映したものです。その情報が表示される時点までに、状況が変更されていることもあります。

省略形: -DIS PROC


v 『環境』

v 『許可』







許可このコマンドを実行するには、次の特権または権限のいずれかを含む処理の特権セットを使用する必要があります。v ストアード・プロシージャーの所有権v DISPLAY 特権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限

-DISPLAY PROCEDURE *.* または schema.partial-name* を指定する場合、処理の特権セットに、次の権限のいずれかを含める必要があります。v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限



構文

�� DISPLAY PROCEDURE

�

(*.*)

,

( schema.procedure-name )schema.partial-name*procedure-namepartial-name*

�

�LOCAL

SCOPE ( GROUP )

��

オプションの説明(*.*)

DB2 の開始以降に DB2 アプリケーションがアクセスした、すべてのスキーマ内のすべてのストアード・プロシージャーの情報を表示します。

(schema.procedure-name)指定されたスキーマ内の指定されたストアード・プロシージャーを表示します。

(schema.partial-name*)DB2 の開始後に DB2 アプリケーションがアクセスした、指定されたスキーマ内のストアード・プロシージャーのセットを表示します。このセット内のすべてのプロシージャーの名前は partial-name で始まり、任意のストリング (空白ストリングを含む) で終わることができます。例えば PAYROLL.ABC* は、PAYROLL スキーマ内の ABC で始まる名前を持つすべてのストアード・プロシージャー名の情報を表示します。

(procedure-name)SYSPROC スキーマ内の、1 つ以上のストアード・プロシージャー名を特定して表示します。プロシージャーを指定しないと、DB2 は DB2 アプリケーションがアクセスしたすべてのストアード・プロシージャーの情報を表示します。

(partial-name*)DB2 の開始後に DB2 アプリケーションがアクセスした、SYSPROC スキーマ内のストアード・プロシージャーのセットを表示します。このセット内のすべてのプロシージャーの名前は partial-name で始まり、任意のストリング (空白ストリングを含む) で終わることができます。例えば ABC* は、SYSPROC スキーマ内の ABC で始まる名前をもつすべてのストアード・プロシージャーの情報を表示します。


-DISPLAY PROCEDURE (DB2)


(LOCAL)ローカル・メンバーについてのみ、プロシージャーの情報を表示するように指定します。

(GROUP)データ共用グループの全メンバーについて、プロシージャーの情報を表示するように指定します。

出力出力例: この DISPLAY PROCEDURE コマンドでは、次のような出力を生成します。

DSNX940I = DSNX9DIS DISPLAY PROCEDURE REPORT FOLLOWS -

PROCEDURE STATUS ACTIVE QUED MAXQ TIME FAIL WLM_ENVAPPL1 STARTED 1 0 0 0 1 SANDBOXAPPL2 STARTED 1 0 0 0 0 SANDBOXAPPL2 STARTED 0 1 2 0 0 SANDBOXAPPL5 STOPREJ 0 0 0 0 0 SANDBOXAPPL6 STOPABN 0 0 0 0 0 SANDBOXPROC1 STOPQUE 0 0 0 0 0 SANDBOX

DSNX9DIS DISPLAY PROCEDURE REPORT COMPLETEDSN9022I = DSNX9COM ’-DISPLAY PROC’ NORMAL COMPLETION

出力の説明: 各出力行には、次の情報が表示されます。

PROCEDUREストアード・プロシージャーの名前。

STATUSストアード・プロシージャーの状況。可能な値には、以下のものがあります。

STARTED プロシージャーに対する要求を処理できます。

STOPQUE 要求は待ち行列に入れられています。

STOPREJ 要求はリジェクトされています。

STOPABN 要求は異常終了のためリジェクトされています。

ACTIVEロード・モジュールを現在実行しているスレッドの数。

QUED プロシージャーがスケジュールされるのを待機しているスレッドの数。

MAXQDB2 の開始以降、プロシージャーがスケジュールされるのを同時に待機したスレッドの最大数。 DB2 は、START PROCEDURE コマンドが実行されるたびに、この値を 0 にリセットします。

TIMEプロシージャーをスケジュールするための要求を待機中に SQL CALL ステートメントにタイムアウトが生じた回数。 DB2 は、START PROCEDURE

コマンドが実行されるたびに、この値を 0 にリセットします。

FAIL プロシージャーが失敗した回数。DB2 は、START PROCEDURE コマンドが実行されるたびに、この値を 0 にリセットします。


第 29 章 -DISPLAY PROCEDURE (DB2) 199

||||||||||||

|

|

|

メッセージ DSNX943I は、STOP PROCEDURE コマンドに次の例のようなパターン・マッチング文字 (*) が付いた部分的に指定した名前が含まれていたために、停止したプロシージャーの範囲をリストします。

-STOP PROCEDURE(ABC*)

あるプロシージャー名に DISPLAY PROCEDURE が出されたが、DB2 がそれにアクセスしたことがなかった場合、メッセージ DSNX950I が戻されます。

例例 1: DB2 アプリケーションによってアクセスされたすべてのストアード・プロシージャーについての情報を表示します。

-DISPLAY PROCEDURE


DSNX940I = DSNX9DIS DISPLAY PROCEDURE REPORT FOLLOWS-PROCEDURE STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENVUSERPRC1 STARTED 0 0 1 0 0 SANDBOXUSERPRC2 STOPQUE 0 5 5 3 0 SANDBOXUSERPRC3 STARTED 2 0 6 0 0 SANDBOXUSERPRC4 STOPREJ 0 0 1 0 0 SANDBOXDSNX9DIS DISPLAY PROCEDURE REPORT COMPLETEDSN9022I = DSNX9COM ’-DISPLAY PROC’ NORMAL COMPLETION

例 2: SYSPROC スキーマ内の特定のストアード・プロシージャーの情報を表示します。

-DISPLAY PROCEDURE(SYSPROC.USERPRC2,USERPRC4)


DSNX940I = DSNX9DIS DISPLAY PROCEDURE REPORT FOLLOWS-

------ SCHEMA=SYSPROCPROCEDURE STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENVUSERPRC2 STOPQUE 0 5 5 3 0 SANDBOXUSERPRC4 STOPREJ 0 0 1 0 0 SANDBOXDSNX9DIS DISPLAY PROCEDURE REPORT COMPLETEDSN9022I = DSNX9COM ’-DISPLAY PROC’ NORMAL COMPLETION

例 3: PAYROLL スキーマと HRPROD スキーマ内のストアード・プロシージャーの情報を表示します。

-DISPLAY PROCEDURE(PAYROLL.*,HRPROD.*)



------ SCHEMA=PAYROLLPROCEDURE STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENVPAYPRC1 STARTED 0 0 1 0 0 PAYROLLPAYPRC2 STOPQUE 0 5 5 3 0 PAYROLLPAYPRC3 STARTED 2 0 6 0 0 PAYROLLUSERPRC4 STOPREJ 0 0 1 0 0 SANDBOX

------ SCHEMA=HRPRODPROCEDURE STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENVHRPRC1 STARTED 0 0 1 0 0 HRPROCS



HRPRC2 STOPREJ 0 0 1 0 0 HRPROCSDSNX9DIS DISPLAY PROCEDURE REPORT COMPLETEDSN9022I = DSNX9COM ’-DISPLAY PROC’ NORMAL COMPLETION

例 4: DB2 アプリケーションがアクセスした、SYSADM スキーマ内のすべてのストアード・プロシージャーの情報を表示します。以下のコマンドを出す時点で、-STOP PROCEDURE(SYSADM.SP*) ACTION(QUEUE) コマンドが発行済みで有効な状態にあるとします。

-DISPLAY PROCEDURE(SYSADM.*)



------ SCHEMA=SYSADMPROCEDURE STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENVSPC1 STOPQUE 0 0 0 0 0 WLMENV1SPC2 STOPQUE 0 0 0 0 0 WLMENV3DSNX9DIS PROCEDURES SP - SP* STOP QUEUEDSNX9DIS DISPLAY PROCEDURE REPORT COMPLETEDSN9022I = DSNX9COM ’-DISPLAY PROC’ NORMAL COMPLETION


第 29 章 -DISPLAY PROCEDURE (DB2) 201

第 30 章 -DISPLAY RLIMIT (DB2)

DB2 コマンド DISPLAY RLIMIT は、リソース限定機能 (管理プログラム) の現在の状況を表示します。この機能がすでに開始済みの場合には、使用中のリソース限定表の ID も DISPLAY RLIMIT によって表示されます。

省略形: -DIS RLIM


v 『環境』

v 『許可』

v 『構文』

v 『例』







構文

�� DISPLAY RLIMIT ��

例リソース限定機能の現在の状況を表示します。

-DISPLAY RLIMIT

リソース限定機能 (RLF) が非アクティブな場合、次の出力が生成されます。


DSNT701I - RESOURCE LIMIT FACILITY IS INACTIVEDSN9022I - DSNTCDIS ’DISPLAY RLIMIT’ NORMAL COMPLETION

RLF がアクティブであり、パネル DSNTIPP のフィールド RESOURCE AUTHID

の値が SYSADM で、かつ開始されたリソース限定表に RLST NAME SUFFIX =

03 が指定されていた場合、次のような出力が生成されます。

DSNT700I = SYSADM.DSNRLST03 IS THE ACTIVE RESOURCE LIMITSPECIFICATION TABLEDSN9022I = DSNTCDIS ’DISPLAY RLIMIT’ NORMAL COMPLETION

-DISPLAY RLIMIT (DB2)


第 31 章 -DISPLAY THREAD (DB2)

DB2 コマンド DISPLAY THREAD は、DB2 スレッドについての現行状況の情報を表示します。DB2 スレッドとは、関連スレッド、データベース・アクセス・スレッド、または並列タスク・スレッドです。スレッドは、アクティブ、非アクティブ、未確定、または延期の状態があり得ます。

分散スレッドとは、リモート・ロケーションとの接続を持つスレッド (アクティブまたは非アクティブ) または、リモート・ロケーションとの接続を持っていたスレッド (未確定) です。関連スレッドと並列タスク・スレッドは、分散または非分散であり得ます。データベース・アクセス・スレッドは常に分散です。

DISPLAY THREAD コマンドを使用すると、以下に記載した 1 つ以上の基準を使用して表示したい情報タイプを選択することができます。

v アクティブ・スレッド、非アクティブ・スレッド、未確定スレッド、延期スレッド、またはアクティブ、未確定、延期スレッドのセット (詳細は、TYPE オプションの説明を参照)

v 関連スレッド (接続名が指定されているアドレス・スペースに関連した上記スレッドを含む)

v 分散スレッド (特定のリモート・ロケーションに関連するスレッドを含む)

v リモート・ロケーションとの接続に関する詳細情報

v 特定の作業論理単位 ID (LUWID)

DISPLAY THREAD コマンドが戻す情報は、動的状況を反映したものです。情報が表示される時点では、状況がすでに変化していることもあります。さらに、情報が整合性を持つのは 1 アドレス・スペース内のみであり、表示されるすべてのアドレス・スペースを通して整合性があるとは限りません。

省略形: -DIS THD


v 206ページの『環境』









データ共用範囲: グループまたはローカル。SCOPE オプションにより異なります。



-DISPLAY THREAD (DB2)


|

構文

�� DISPLAY THREAD

�

( ),

connection-namepartial-connection*

*

�

�LOCAL

SCOPE ( GROUP )ACTIVE

TYPE( INDOUBT )*INACTIVEPOSTPONED

�

�

�

�

,

LOCATION( location-name )partial-location*

*,

LUWID( luwid )partial-luwid*token

DETAIL�

�

�

,

RRSURID( rrs-urid )*

��

オプションの説明以下の一覧に示されているとおり、ある特定の条件下においてのみ、以下のオプションのいずれかが必要となります。

(connection-name) と (*) のどちらも指定しない場合は、以下の規則が適用されます。

v このコマンドの入力は、TSO 下の DSN セッション、DB2I パネル (DB2

COMMANDS)、IMS または CICS 端末から行うことができ、接続名は関連したアドレス・スペースから継承されます。

v コマンドが出されたのが上記のいずれの環境でもない場合、次の規則が適用されます。

– LOCATION と LUWID のどちらも指定しないと、処理が終了して DSNV413I

メッセージが出されます。


第 31 章 -DISPLAY THREAD (DB2) 207

– LOCATION または LUWID を指定した場合は、TYPE オプションによって選択されたタイプの分散スレッドのみが表示されます。

– location-name を明示的に指定した場合は、TYPE オプションで指定したタイプの分散スレッドだけが表示されます。この分散スレッドには、指定のロケーションとの接続があるもの (アクティブまたは非アクティブ・スレッド)、あるいは以前に接続があったもの (未確定スレッド) です。

(connection-name, ...)1 つ以上の接続名 (それぞれ 1 ～ 8 文字) を列挙します。関連スレッドは、それらの接続名に関連したアドレス・スペースからのみ選ばれます。LOCATION

オプションは以下のようにして表示対象を制限します。

v LOCATION(*) を指定した場合は、TYPE オプションに指定されたタイプの分散スレッドのみが表示されます。

v location-name を明示的に指定した場合は、指定したタイプの分散スレッドだけが表示されます。この分散スレッドには、指定のロケーションとの接続があるもの、あるいは以前に接続があったものです。

(partial-connection*, ...)ストリング partial-connection で始まり、任意のストリング (空白ストリングを含む) で終わる接続を選択します。例えば DISPLAY THREAD(CICS*,IMS*) であれば、ストリング ’CICS’ または ’IMS’ で始まるすべての接続名が選択されます。LOCATION オプションを使用すれば、前述の location-name とまったく同じ方法で表示を制限できます。

(*)DB2 に接続するすべてのアドレス・スペース内のすべてのスレッド、およびTYPE オプションに指定したタイプのすべてのデータベース・アクセス・スレッドを表示します。LOCATION オプションは以下のようにして表示対象を制限します。

v LOCATION(*) を指定すると、分散スレッドのみが表示されます。

v location-name を明示的に指定した場合は、分散スレッドだけが表示されます。この分散スレッドには、指定のロケーションとの接続があるもの (アクティブまたは非アクティブ・スレッド)、あるいは以前に接続があったもの (未確定スレッド) です。

デフォルトでは、コマンドの入力が行われたトランザクション管理プログラムに関連した接続のみが表示されます。


(LOCAL)現行メンバーのみのスレッドを表示します。

(GROUP)データ共用グループのすべてのスレッドを表示します。

TYPE表示するスレッドのタイプを示します。

省略形: T



|

|

|

|

|

|

(ACTIVE)アクティブ・スレッドのみを表示します。アクティブ関連スレッドは、TSO、BATCH、IMS、CICS、または CAF を介して DB2 に接続されます。アクティブ・データベース・アクセス・スレッドは VTAM を介して別のシステムに接続され、そのシステムに代わって作業を実行します。コマンド処理中にアクティブ・スレッドが未確定になると、このスレッドは合計 2

回、1 度はアクティブ・スレッドとして、もう 1 度は未確定スレッドとして表示されることがあります。

省略形: A

ACTIVE によって作成される情報、特にメッセージ DSNV403I およびDSNV404I はデバッグの目的に役立つ可能性があります。これらのメッセージの内容については、「DB2 メッセージ」第 2 部に記載されています。

(INDOUBT)未確定スレッドのみを表示します。

未確定スレッドとは、2 フェーズ・コミット・プロトコルにおける参加プログラムのうち、コミットの最初のフェーズを完了した後にコミット・コーディネーターと通信できなくなったため、行われた更新をコミットするかロール・バックするかが不明なもののことです。

表示される未確定スレッド情報には、DB2 の役割がコーディネーター、参加プログラム、あるいはコーディネーターと参加プログラムの両方であるスレッドが含まれます。

関連スレッドのコミット・コーディネーターとなるのは、トランザクション・マネージャー (例えば、IMS や CICS など)、または RRSAF を使用するスレッドの場合は z/OS RRS です。また、データベース・アクセス・スレッドのコミット・コーディネーターとなるのは、リモート・システムにあるリクエスターです。

未確定スレッドは、更新されたリソースすべてに対するロックを保持します。

省略形: I

(*) アクティブ、未確定、および延期スレッドを表示します。

(INACTIVE)非アクティブ・スレッドのみを表示します。非アクティブ・スレッドとは、VTAM を介して別のシステムに接続し、新しい作業単位がそのシステムから開始するのを待っているアイドル状態のデータベース・アクセス・スレッドのことです。

省略形: INA

このオプションと一緒に、完全ロケーション名または LUWID などの修飾子を使用します。非アクティブ・データベース・アクセス・スレッドの数が多いと、非修飾の表示要求により、DB2 実効ページ・セットが一時的に変更される可能性があり、その結果、アクティブ・スレッドのパフォーマンスに一時的に影響を与える場合があります。

(POSTPONED)バックアウト処理が延期された作業単位の情報を表示します。



省略形: P

延期されたスレッドを確認した後に、345 ページに示されている「RECOVER POSTPONED」コマンドを使用して、延期された作業単位のバックアウト処理を完了させます。

LOCATION(location-name, ...)以下の説明のように、表示を分散スレッドに限定します。

省略形: LOC

location-name

指定のタイプの分散スレッドのうち、指定された location-name とのリモート接続があるもの (アクティブまたは非アクティブ・スレッド)、あるいは以前にリモート接続があったもの (未確定スレッド) だけを表示します。

DB2 は DB2 UDB for z/OS サブシステムでないリクエスターからのロケーション名を受け取りません。DB2 UDB for z/OS サブシステム以外のリクエスター情報を表示するには、そのリクエスターの LU 名または IP アドレスを入力してください。この LU 名を、より小 (<) 記号とより大 (>) 記号で囲んでください。この IP アドレスは、nnn.nnn.nnn.nnn の形式で入力してください。例えば、次のコマンドは LU 名が LULA であるリモート・ロケーション (DB2 UDB for z/OS 以外) についての情報を表示します。

-DISPLAY THREAD (*) LOCATION (<LULA>)

次のコマンドは、IP アドレスが 123.34.101.98 であるリモート・ロケーション (DB2 UDB for z/OS 以外) についての情報を表示します。

-DISPLAY THREAD (*) LOCATION (123.34.101.98)

DB2 は、DB2 以外のリクエスター情報を表示するメッセージの中で、<LU

name> 表記または IP アドレスを使用します。

partial-location*ストリング partial-location で始まり、任意のストリング (空白ストリングを含む) で終わるすべてのロケーション名を選択します。例えば、LOCATION(SAN*) の場合にはストリング ’SAN’ で始まるロケーション名すべてが選択されます。

DB2 UDB for z/OS サブシステム以外の他のロケーション名に関して前述したのと同じ方法で、LU 名指定時にアスタリスク (*) を使用することができます。例えば、LOCATION(<LULA*) は、LU 名がストリング ’LULA’ で始まるすべてのリモート・ロケーション (DB2 UDB for z/OS 以外) を選択します。

IP アドレスを指定するときは、アスタリスクは使用できません。

(*) 指定されたタイプの分散スレッドをすべて表示します。

LUWID(luwid, ...)指定された LUWID をもつ分散スレッドに関する情報を表示します。複数のスレッドが同じ LUWID を持つこともあり得ます。

luwid

完全修飾 LU ネットワーク名、ピリオド、LUW インスタンス番号の順で構成されています。



LU ネットワーク名は、1 ～ 8 文字のネットワーク ID、ピリオド、および1 ～ 8 文字のネットワーク LU 名で構成されます。LUW インスタンス番号は、作業単位を固有に識別する 12 個の 16 進数文字で構成されます。

partial-luwid*ストリング partial-luwid で始まり、任意のストリング (空白ストリングも含む) で終わるすべての LUWID を選択します。例えば LUWID(NET1.*) はネットワーク名が ’NET1’ であるすべての LUWID を選択します。

token

別の方法で特定のスレッドを識別します。DB2 は、作成した各分散スレッドにトークンを割り当てます。トークンは 1 ～ 6 桁の 10 進数で、LUWID を表示するすべての DB2 メッセージで等号の後ろに表示されます。

LUWID にピリオドも ’*’ も指定されていない場合、DB2 はユーザーがトークンを指定しているものと見なします。DB2 が特定の LUWID に割り当てたトークンはその DB2 サブシステムでは固有のものですが、必ずしもサブシステム全体で固有であるとは限りません。

DETAILアクティブ、非アクティブ、および未確定スレッドに関する追加情報を表示します。

RRSURID(rrs-urid)指定した RRSURID 選択基準に一致するスレッドのみが表示されるように指定します。

v RRSURID(rrs-urid) を指定した場合、rrs-urid 値を持つ RRSURID に関係したすべてのスレッドで、かつ、指定された他のどの選択基準をも満足するスレッドが表示されます。

v RRSURID(*) と指定した場合、すべての RRSURID に関係するすべてのスレッドで、指定された他の選択基準すべてを満足するスレッドが表示されます。

使用上の注意分散スレッドに関する定様式レポート: 分散スレッドの DISPLAY THREAD TYPE

(ACTIVE または INACTIVE) に関する定様式レポートには、DSNV444I ～DSNV446I の一連のメッセージが追加されます。この定様式レポートの説明については、「DB2 メッセージ」第 2 部に記載されているこれらのメッセージを参照してください。

プライベート・プロトコルと DRDA アクセスを使用するスレッド: リクエスターに接続されるデータベース・アクセス・スレッドを、 DB2 プライベート・プロトコル・アクセスまたは DRDA アクセスを使用する別のデータベース・サーバー・ロケーションに接続することもできます。このケースでは、DB2 から、リクエスターにはメッセージ DSNV445I が発行され、リモート・サーバー接続にはメッセージDSNV444I とゼロまたはいくつかの DSNV446I メッセージが発行されます。この場合、データベース・アクセス・スレッドは、中間のデータベース・サーバーとして働きます。



コミット / 打ち切りの判断を待つ参加プログラム・スレッド: コミット処理のフェーズ 1 を完了し、コーディネーターからのコミット / 打ち切りの判断を 60 秒より長く待っているアクティブ参加プログラム・スレッドに対しては、DSNV465I メッセージが発行されます。

DISPLAY THREAD 出力制限: DISPLAY THREAD コマンドが z/OS コンソールから発行される場合、コマンドの 1 回の呼び出しにつき出力できる最大行数は 255

行です (このとき、DSNV421I または DSNV422I メッセージが印刷されます)。出力の最初の 255 行で必要な情報を得られなかったときは、TYPE オプションと特定の接続名、ロケーション、luwid、あるいはそれらの組み合わせ (適切であれば) を指定して、出力を減らすようにして、このコマンドをもう一度出します。

並列タスクの表示: DISPLAY THREAD コマンドでは、状況タイプ PT を使用すると、並列タスクが表示されます。並列タスクは、親タスクの直後に表示されます。そのスレッドが PT の状況にある場合、親タスクのスレッドが同じ DB2 サブシステム上で実行されていると接続名にはブランクが入ります。これにより、これらの並列タスクが親タスクに関連していることが分かります。親タスクが実行しているサブシステム以外の DB2 サブシステムで並列タスクが稼働している場合は、接続名が表示され、そのエントリーの後ろにメッセージ DSNV443I が表示されます。

XID の表示: TYPE ACTIVE および DETAIL オプションまたは TYPE INDOUBT

オプションを指定して DISPLAY THREAD コマンドを出すと、メッセージDSNV440I に XID の内容が表示されます。XID の内容は 16 進値で表示されます。

未確定トランザクションが XID に関連している場合は、XID は DISPLAY

THREAD TYPE INDOUBT レポートに表示されます。

出力表 18 には、DISPLAY THREAD コマンドの例とそれらのコマンドが生成する出力タイプが記載してあります。各行の数字は、一覧表の下にある説明を参照しています。DETAIL キーワードは、分散スレッドについて表示される情報の量だけに影響するため、ここに含まれていません。

RRSURID(*) と指定した場合、どの RRSURID にも関係するスレッドのみが表示されます。RRSURID(rrs-urid) と指定した場合、この指定された RRSURID に関係するスレッドのみが表示されます。

表 18. サンプルの DISPLAY THREAD コマンド：以下の出力は、TYPE の指定が異なるさまざまな環境でコマンドが発行された場合に生成されます。(TYPE(*) を指定すると、1 つの報告書で TYPE(ACTIVE) と TYPE(INDOUBT) の両方を指定した場合と同じ出力が表示されます。)

コマンドが出される環境コマンド ACTIVE INDOUBT INACTIVE

接続名が受け継がれた TSO、DB2I、IMS、または CICS 下のDSN セッション

-DIS THD 1 1 2

-DIS THD LOC(*) 3 3 2

-DIS THD LOC(location-name) 4 4 2



表 18. サンプルの DISPLAY THREAD コマンド (続き)：以下の出力は、TYPE の指定が異なるさまざまな環境でコマンドが発行された場合に生成されます。(TYPE(*) を指定すると、1つの報告書で TYPE(ACTIVE) と TYPE(INDOUBT) の両方を指定した場合と同じ出力が表示されます。)


z/OS コンソール -DIS THD 6 6 6

-DIS THD LOC(*) 9 9 8

-DIS THD LOC(location-name) 10 10 11

任意のソース -DIS THD(connection-name) 1,12 1,12,15 12

-DIS THD(connection-name)

LOC(*)

3,12 3,12,15 12


LOC(location-name)

4,13 4,13,15 13

-DIS THD(*) 7 7,15,16 8

-DIS THD(*) LOC(*) 9 9,15,16 8

-DIS THD(*)

LOC(location-name)

10 10,15,16 11

-DIS THD(*) LUWID(luwid

または token)

5 5,15,16 5


LUWID(luwid または token)

14 14,15,16 14

-DIS THD LUWID(luwid または token)

5 5,15,16 5



表 18. サンプルの DISPLAY THREAD コマンド (続き)：以下の出力は、TYPE の指定が異なるさまざまな環境でコマンドが発行された場合に生成されます。(TYPE(*) を指定すると、1つの報告書で TYPE(ACTIVE) と TYPE(INDOUBT) の両方を指定した場合と同じ出力が表示されます。)


生成される表示の説明:

1. 接続名をもつ、指定された TYPE の関連スレッド。2. スレッドなし (非アクティブ・スレッドはデータベース・アクセス・スレッドであり、継承された接続名を持たない)。

3. 接続名をもつ、指定された TYPE の分散関連スレッド。4. 接続名をもち、分散接続 = location-name である指定された TYPE の分散関連スレッド。

5. LUWID = luwid または token をもつ指定された TYPE のスレッド。6. エラーを示すメッセージ DSNV413I が表示されます。7. 指定された TYPE のすべてのスレッド (接続とデータベース・アクセスの両方)

8. すべての非アクティブ・データベース・アクセス・スレッド。9. 指定された TYPE のすべての分散スレッド (接続とデータベース・アクセスの両方)。

10. 分散接続 = location-name をもつ、指定された TYPE のすべての分散スレッド (接続とデータベース・アクセス・スレッドの両方)。

11. 分散接続 = location-name をもつ、すべての非アクティブ・データベース・アクセス・スレッド。

12. 接続名をもつ、指定された TYPE のデータベース・アクセス・スレッド。13. 接続名と分散接続 = location-name をもつ、指定された TYPE のデータベース・アクセ

ス・スレッド。14. 接続名と LUWID = luwid または token をもつ指定された TYPE のスレッド。15. メッセージ DSNV407 および DSNV408 は、コーディネーターの TCP/IP の再同期ポート番号も表示。メッセージ DSNV446 は参加者の TCP/IP 再同期ポート番号も表示。

16. メッセージ DSNV440I は、XA トランザクション・マネージャー・コーディネーターと関連する、指定された TYPE の分散スレッドに関するリモート・クライアントの XID

の内容を表示 (16 進表記)。

DETAIL オプションを指定すると、次の追加情報が表示されます。

LOCATION

リモート・システムのロケーション名。

SESSID

VTAM 接続の場合、会話が実行されているセッションの VTAM 定義のセッション・インスタンス ID 。

TCP/IP 接続の場合、ローカルおよびリモート TCP/IP ポート番号で、形式は local:remote。local はローカル DB2 サブシステムのポート番号です。remote はリモート・パートナーのポート番号です。

A VTAM または TCP/IP に会話の制御権がある場合 (DB2 がその会話に関して、スレッドの制御権を VTAM または TCP/IP に渡した場合)、A (アクティブ) 欄に V が表示されます。W は、VTAM イベントが完了したことをVTAM が DB2 サブシステムに通知するまで、DB2 サブシステムがこの会話の処理を延期していることを示します。それ以外の場合、この欄には何も示されません。



STATUS

この 2-byte バイトの欄には、会話またはソケットの状況が示されます。以下は、STATUS に対して考えられる値です。

値状況Sx 送信Rx 受信Ax 割り振りDx 割り振り解除Cx セッション数変更 (CNOS) 処理Xx ログ名交換処理blank 上記のいずれの状態でもない

x には以下のいずれかの値が入ります。1 = 単一フェーズ・コミットを使用するプライベート・プロトコル会話2 = 単一フェーズ・コミットを使用する DRDA 会話3 = 2 フェーズ・コミットを使用するプライベート・プロトコル会話4 = 2 フェーズ・コミットを使用する DRDA 会話

アクティブ、非アクティブ、または未確定スレッドに対して DETAIL キーワードを指定すると、DB2 は、メッセージ DSNV441I も表示します。このメッセージにはアカウンティング接尾部情報を文字ストリングで表示されます。DB2 は、アカウンティング情報を認識し、以下のシステムが作成元の接尾部情報を表示します。

v DB2 UDB for z/OS システム

v アカウンティング情報が、DSNSQMDA.QMDASQLI に記述されているフォーマットと一致する任意のシステムで、このアカウンティング情報には、製品 ID 接頭部 JCC (DB2 Universal JDBC ドライバー) および SQL (DB2 Universal Database

for Linux、UNIX、および Windows) が含まれます。

アクティブ・スレッドに対して DETAIL オプションを指定すると、DB2 は、メッセージ DSNV440I も表示します。このメッセージは、リモート・クライアントのXID の内容を表示します (16 進表記)。

例例 1: コマンド DISPLAY THREAD の出力には、分散であるかどうかに関係なくすべてのスレッドのトークンが示されます。この例では、分散ではない関連スレッドのトークンが示されています。トークンは 123 となっています。スレッドのトークンは、CANCEL THREAD コマンドにおけるパラメーターとして使用できます。

-DISPLAY THREAD(*) DETAIL


DSNV401I - DISPLAY THREAD REPORT FOLLOWS -DSNV402I - ACTIVE THREADS -NAME ST A REQ ID AUTHID PLAN ASID TOKENBATCH T * 5 BKH2C SYSADM BKH2 000D 123DISPLAY ACTIVE REPORT COMPLETEDSN9022I - DSNVDT ’-DIS THD’ NORMAL COMPLETION

例 2: この例は、アクティブ・スレッドの分散情報を表示した場合の、会話活動の情報を示しています。DB2 は次の出力を戻します。この出力は、ローカル・サイト



のアプリケーションが DB2 に会話が割り振られるのを待っていることを示しているほか、TCP/IP を使用して DRDA クライアントにより DB2 サーバーがアクセスされることを示しています。

-DISPLAY THREAD(*) LOCATION(*) DETAIL


DSNV401I - DISPLAY THREAD REPORT FOLLOWS -DSNV402I - ACTIVE THREADS -

NAME ST A REQ ID AUTHID PLAN ASID TOKENTSO TR * 3 SYSADM SYSADM DSNESPRR 002E 2V436-PGM=DSNESPRR.DSNESM68, SEC=1, STMNT=116V444-DB2NET.LUND0.A238216C2FAE=2 ACCESSING DATA ATV446-USIBMSTODB22:LUND1V447--LOCATION SESSID A ST TIMEV448--USIBMSTODB22 0000000000000000 V A1 9015816504776TSO RA * 11 SYSADM SYSADM DSNESPRR 001A 15V445-STLDRIV.SSLU.A23555366A29=15 ACCESSING DATA FOR 123.34.101.98V447--LOCATION SESSID A ST TIMEV448--123.34.101.98 446:3171 S2 9015611253108

DISPLAY ACTIVE REPORT COMPLETEDSN9022I - DSNVDT ’-DIS THD’ NORMAL COMPLETION

例 3: この例では、サイト 1 のシステムに TSO アプリケーションと IMS アプリケーションがあります。サイト 1 のシステムは、DB2 が TSO アプリケーションをコミットした後で、かつコミット決定がサイト 2 およびサイト 3 の関係するサブシステムに伝達される前に失敗します。この失敗が起こるのは、IMS がコミットまたはロールバック決定をサイト 1 の DB2 サブシステムに伝達する前です。このDISPLAY THREAD コマンドは、サイト 1 の DB2 サブシステムの再始動後で、かつ IMS に再接続する前に発行されます。各ロケーションで出される DISPLAY

THREAD コマンドは、次のような出力を表示します。

次の DISPLAY THREAD コマンドはサイト 1 から出されます。

-DISPLAY THREAD(*) TYPE(INDOUBT)


DSNV401I - DISPLAY THREAD REPORT FOLLOWS -DSNV406I - INDOUBT THREADS -COORDINATOR STATUS RESET URID AUTHIDSTLIMS01 INDOUBT 0F201050A010 SM09HV467-HAS LUWID IBM.STLDB21.15A86A876789.0010=1V449-HAS NID=A5 AND ID=STLIMS01V450-HAS PARTICIPANT INDOUBT ATV446--IBMSJ0DB20001:STLDB22IBMSTLDB20001 COMMITTED 0F20105B0000 JO78SV467-HAS LUWID IBM.STLDB21.16B57B954427.0003=2V450-HAS PARTICIPANT INDOUBT ATV446--IBMSJ0DB20001:STLDB22 IBMLA0DB20001:STLDB23DISPLAY INDOUBT REPORT COMPLETE -DSN9022I - DSNVDT ’-DIS THD’ NORMAL COMPLETION

次の DISPLAY THREAD コマンドは Site 2 から出されます。

-DISPLAY THREAD(*) TYPE(INDOUBT)


DSNV401I - DISPLAY THREAD REPORT FOLLOWS -DSNV406I - INDOUBT THREADS -COORDINATOR STATUS RESET URID AUTHID



IBMSTLDB20001:STLDB21 INDOUBT 03201050A010 HEU4443V467-HAS LUWID IBM.STLDB21.15A86A876789.0010=8V466-THREAD HAS BEEN INDOUBT FOR 00:05:20IBMSTLDB20001:STDB21 INDOUBT 03201050B000 PP433MMV467-HAS LUWID IBM.STLDB21.16B57B954427.0003=6DISPLAY INDOUBT REPORT COMPLETEDSN9022I - DSNVDT ’-DIS THD’ NORMAL COMPLETION

次の DISPLAY THREAD コマンドは Site 3 から出されます (ACTIVE スレッドとINDOUBT スレッドの両方が表示されます)。

-DISPLAY THREAD(*) TYPE(*) DETAIL


DSNV401I - DISPLAY THREAD REPORT FOLLOWS -DSNV402I - ACTIVE THREADS -NAME ST A REQ ID AUTHID PLAN ASID TOKENSERVER RA * 0 RUW2STAT JONES DISTSERV 0005 4V465-THREAD HAS BEEN PREPARED FOR 00:05:20V445-IBM.STLDB21.15A86A876789=4 ACCESSING DATA FOR

IBMSJ0DB20001:STLDB21V447--LOCATION SESSID A ST TIMEV448--IBMSJ0DB20001 0000000400000004 W R4 9034817015032DISPLAY ACTIVE REPORT COMPLETEDSNV406I - INDOUBT THREADS -COORDINATOR STATUS RESET URID AUTHIDIBMSTLDB20001:STLDB21 INDOUBT 03201050B000 SM43YY33V467-HAS LUWID IBM.STLDB21.16B57B954427.0003=5V466-THREAD HAS BEEN INDOUBT FOR 00:05:20DISPLAY INDOUBT REPORT COMPLETEDSN9022I - DSNVDT ’-DIS THD’ NORMAL COMPLETION

例 4: この例では、ストアード・プロシージャーで実行しているスレッドと、ストアード・プロシージャーがスケジュールされるのを待っているスレッドが表示されます。あるアプリケーションがまずプロシージャー PROC1 に、それから PROC2

に呼び出しを行ったとします。そして PROC2 は STOP QUEUE 状態にあります。

実行中の PROC1 の出力では、ST の欄に SP という状況が表示され、ストアード・プロシージャーでスレッドが実行中であることを示します。

-DISPLAY THREAD(*)


DSNV401I - DISPLAY THREAD REPORT FOLLOWS -DSNV402I - ACTIVE THREADS - 176NAME ST A REQ ID AUTHID PLAN ASID TOKENBATCH SP 3 RUNAPPL SYSADM PL01AP01 001D 43V429 CALLING STORED PROCEDURE PROC1, LOAD MODULE LMPROC1DISPLAY ACTIVE REPORT COMPLETEDSN9022I - DSNVDT ’-DISPLAY THREAD’ NORMAL COMPLETION

キューに入っているときの PROC2 の出力には、ST の欄に SW の状況が表示され、これはスレッドが、ストアード・プロシージャーがスケジュールされるのを待っていることを示します。

-DISPLAY THREAD(*)


DSNV401I - DISPLAY THREAD REPORT FOLLOWS -DSNV402I - ACTIVE THREADS - 198NAME ST A REQ ID AUTHID PLAN ASID TOKEN



BATCH SW * 13 RUNAPPL SYSADM PL01AP01 001D 43V429 CALLING STORED PROCEDURE PROC2, LOAD MODULEDISPLAY ACTIVE REPORT COMPLETEDSN9022I - DSNVDT ’-DISPLAY THREAD’ NORMAL COMPLETION

例 5: この例では、確立される (プランに従って割り振られる) 接続、非分散の親スレッド (TOKEN=30) を、同じ DB2 システム上で実行しているその並列タスク(PT) と共に表示します。すべての並列タスクは、対応する親スレッドの直後に表示されます。

16.32.57 DB1G DISPLAY THREAD(*)16.32.57 STC00090 DSNV401I DB1G DISPLAY THREAD REPORT FOLLOWS -16.32.57 STC00090 DSNV402I DB1G ACTIVE THREADS -NAME ST A REQ ID AUTHID PLAN ASID TOKENBATCH T * 1 PUPPYDML USER001 DSNTEP3 0025 30

PT * 641 PUPPYDML USER001 DSNTEP3 002A 40PT * 72 PUPPYDML USER001 DSNTEP3 002A 39PT * 549 PUPPYDML USER001 DSNTEP3 002A 38PT * 892 PUPPYDML USER001 DSNTEP3 002A 37PT * 47 PUPPYDML USER001 DSNTEP3 002A 36PT * 612 PUPPYDML USER001 DSNTEP3 002A 35PT * 545 PUPPYDML USER001 DSNTEP3 002A 34PT * 432 PUPPYDML USER001 DSNTEP3 002A 33PT * 443 PUPPYDML USER001 DSNTEP3 002A 32PT * 252 PUPPYDML USER001 DSNTEP3 002A 31

DISPLAY ACTIVE REPORT COMPLETE16.32.58 STC00090 DSN9022I DB1G DSNVDT ’-DISPLAY THREAD’ NORMALCOMPLETION

例 6: この例は、TCP/IP を使用してリモート DRDA サーバーにアクセスする DB2

クライアントに関する詳細報告書を示しています。

-DISPLAY THREAD(*) LOCATION(*)



NAME ST A REQ ID AUTHID PLAN ASID TOKENBATCH TR * 6 BKH2C SYSADM YW1019C 0009 2V444-STLDRIV.SSLU.A23555366A29=2 ACCESSING DATA ATV446-USIBMSTODB22:123.34.101.98:446V447--LOCATION SESSID A ST TIMEV448--USIBMSTODB22 4019:446 V R2 9015611253116DISPLAY ACTIVE REPORT COMPLETE

DSN9022I - DSNVDT ’-DIS THD’ NORMAL COMPLETION

例 7: この例は、TCP/IP を使用して DRDA クライアントによりアクセスされるDB2 サーバーに関する詳細報告書を示しています。

DISPLAY THREAD(*) LOCATION(*)



NAME ST A REQ ID AUTHID PLAN ASID TOKENBATCH RA * 5 BKH2C SYSADM DISTSERV 0008 2V445-STLDRIV.SSLU.A23555366A29=2 ACCESSING DATA FOR 123.34.101.98V447--LOCATION SESSID A ST TIMEV448--123.34.101.98 446:3171 S2 9015611253108DISPLAY ACTIVE REPORT COMPLETE

DSN9022I - DSNVDT ’-DIS THD’ NORMAL COMPLETION

例 8: この例は、バックアウト処理が延期された作業単位の情報を示しています。



-DISPLAY THREAD (*) TYPE (POSTPONED)


DSNV401I - DISPLAY THREAD REPORT FOLLOWS -DSNV431I - POSTPONED ABORT THREADS -COORDINATOR STATUS RESET URID AUTHIDBATCH ABORT-P 000002FF98EA ADMF001BATCH ABORT-P 000002FF9000 ADMF001DISPLAY POSTPONED ABORT REPORT COMPLETEDSN9022I - DSNVDT ’-DISPLAY THREAD’ NORMAL COMPLETION

例 9: この例は、ユーザー定義関数を実行しているスレッドのトークンを示しています。トークンは 18 です。



DSNV401I - DISPLAY THREAD REPORT FOLLOWS -DSNV402I - ACTIVE THREADS -NAME ST A REQ ID AUTHID PLAN ASID TOKENBATCH T * 231 DISTHD ADMF001 0021 95BATCH SW * 38 INSERT ADMF001 DSNTEP3 0025 18V436-PGM=CLIP74C1.UFIP74C1, SEC=0, STMNT=0V429 CALLING FUNCTION =SCIP7401.SP_UFIP74C1 ,

PROC=V61AWLM3, ASID=0030, WLM_ENV=WLMENV3DISPLAY ACTIVE REPORT COMPLETEDSN9022I - DSNVDT ’-DISPLAY THREAD’ NORMAL COMPLETION

例 10: この例は、RRS リカバリー単位にかかわるスレッドの情報を示しています。

-DISPLAY THREAD(*) RRSURID(*)


- 08.23.58 STC00149 DSNV401I ( DISPLAY THREAD REPORT FOLLOWS -- 08.23.58 STC00149 DSNV402I ( ACTIVE THREADS -- NAME ST A REQ ID AUTHID PLAN ASID TOKEN- RRSAF T 8 TGXID-111 ADMF001 TGXIDR 0023 35- V481-DB2 IS PARTICIPANT FOR RRS URID B4D0FC267EB020000000001101010000- DISPLAY ACTIVE REPORT COMPLETE- 08.23.58 STC00149 DSN9022I ( DSNVDT ’-DIS THD’ NORMAL COMPLETION

例 11: この例は、未確定の RRS リカバリー単位に対し DB2 がコーディネーターとなる、スレッドの情報を示しています。DB2 はこのスレッドをコミットしましたが、RRS でこの RRS UR を解決することはできていません。

-DISPLAY THREAD(*) TYPE(I) RRSURID(*)


- 09.27.21 STC00185 DSNV406I ( INDOUBT THREADS -- COORDINATOR STATUS RESET URID AUTHID- UNKNOWN COMMITTED 123456789ABC UNKNOWN- V480-DB2 IS COORDINATOR FOR RRS URID C4D4FA267EB040000000001201020000

00- DISPLAY INDOUBT REPORT COMPLETE- 09.27.21 STC00185 DSNV434I ( DSNVDT NO POSTPONED ABORT THREADS FOUND- 09.27.21 STC00185 DSN9022I ( DSNVDT ’-DIS THD’ NORMAL COMPLETION

例 12: この例は、XA トランザクション・マネージャーと関連するアクティブ・スレッドの XID を示しています。





#dis thd(*) detDSNV401I # DISPLAY THREAD REPORT FOLLOWS -DSNV402I # ACTIVE THREADS -NAME ST A REQ ID AUTHID PLAN ASID TOKENTEST0001 RX * 2 CTHDCORID001 SYSADM DONSQL1 0036 12V440-XID=53514C20 00000017 00000000 544D4442

00000000 002F93DD A92F8C4F F30000000000BD

V445-USIBMSY.SYEC715A.B5A0992212F4=12 ACCESSING DATA FOR9.30.115.130:5001

V447--LOCATION SESSID A ST TIMEV448--STL715A E15FE002DB8DEDCD W R4 0109210383564DISPLAY ACTIVE REPORT COMPLETEDSN9022I # DSNVDT ’-DIS THD’ NORMAL COMPLETION



第 32 章 -DISPLAY TRACE (DB2)

DB2 コマンド DISPLAY TRACE は、アクティブ・トレースのリストを表示します。このトレース機能について詳しくは、「DB2 管理ガイド」第 4 部 (第 1 巻)を参照してください。

このコマンドの追加のオプションと、このコマンドのいくつかのオプションの追加値については、ここでは説明していません。これらは保守用のもので、IBM サポート担当員の指示に従って使用するものです。詳しくは、「DB2 Diagnosis Guide and

Reference」を参照してください。

省略形: -DIS TRACE


v 『環境』

v 『許可』











|

|

構文

�� DISPLAY TRACE*

( )PERFMACCTGSTATAUDITMONITOR

�

�destination block constraint block DETAIL(output-type)

�

�COMMENT(string) LOCAL

SCOPE ( GROUP )

��

destination block:

��

,

DEST( GTF )SMFSRVOPn

��

-DISPLAY TRACE (DB2)


|||||

constraint block:

��

*,

PLAN( plan-name ) �

*,

AUTHID( auth-id ) �

� �

*,

CLASS( integer ) �

*,

TNO( integer ) �

� �

*,

LOCATION( location-name )<luname>nnn.nnn.nnn.nnn

��

オプションの説明いずれのオプションも必須ではありません。コマンド DISPLAY TRACE はすべてのアクティブ・トレースをリスト表示します。オプション (TNO を除く) を使用した場合、各オプションはこのコマンドの影響をそれと同じオプションに同一のパラメーター値を (明示的に、あるいはデフォルトとして) 指定して開始したアクティブ・トレースに限定します。例えば次のコマンドは、オプション PERFM およびCLASS(1,2) を使用して開始したアクティブ・トレースのみをリストし、例えば、CLASS(1) を使用して開始したトレースをリストしません。

-DISPLAY TRACE (PERFM) CLASS (1,2)

(*) トレースのリストを制限しません。デフォルトは (*) です。

CLASS オプションは DISPLAY TRACE (*) と同時には使用できません。

次のキーワードは、それぞれに対応するタイプのトレースにリストを限定します。各タイプについての詳細な説明は、 407ページの『第 73 章 -START TRACE

(DB2)』を参照してください。

タイプ (省略形) 説明

PERFM (P) 特定のイベントのパフォーマンス・レコード

ACCTG (A) トランザクションごとのアカウンティング・レコード

STAT (S) 統計データ

AUDIT (AU) 監査データ

MONITOR (MON) モニター・データ

DETAIL(output-type)トレースが表示する情報を、括弧内に指定した出力タイプに基づいて制限します。

output-type に指定可能な値は以下のとおりです。


第 32 章 -DISPLAY TRACE (DB2) 223

1 要約トレース情報、すなわち TRACE NUMBER、 TYPE、 CLASS、DEST を表示する

2 修飾トレース情報、すなわち TRACE NUMBER、 AUTHID、 PLAN、LOCATION を表示する

1,2 要約情報と修飾情報の両方を表示する

* 要約情報と修飾情報の両方を表示する

DETAIL の後にパラメーターがない場合は、タイプ 1 のトレース情報が表示されます。

これに加えて QUAL という欄も表示され、トレースが修飾されているかどうかを示します。要約トレース情報の一部である QUAL 欄には、トレースの修飾情報がさらに使用できるかどうかを判別するときに使用できます。この情報は、DETAIL (2) または DETAIL (*) を指定することで入手できます。QUAL 欄の値が YES の値の場合は、この特定のトレースに関する追加情報が修飾トレース情報内に存在していることを示します。NO の値の場合は、このトレースに関する追加情報が存在しないことを示します。

COMMENT(string)コメント string がトレース出力 (常駐のトレース・テーブルにある出力を除く)

に表示されるように指定します。

string は任意の文字ストリングです。ブランク、コンマ、または特殊文字を含んでいる場合はアポストロフィで囲む必要があります。このコメントは画面には表示されませんが、トレース出力に記録することが可能です。ただし、コマンドがトレース中である場合に限ります。


(LOCAL)ローカル・メンバーのトレースのみを表示します。

(GROUP)データ共用グループのすべてのメンバーのトレースを表示します。

DEST特定の宛先について開始したトレースにリストを限定します。複数の値を指定できますが、同じ値を 2 回使用してはなりません。DEST に値を指定しない場合、DB2 は表示されるトレースのリストを制限するにあたって、トレース出力が記録されている宛先を使用しません。

省略形: D

指定可能な値とその意味は以下のとおりです。

値トレースの宛先GTF 汎用トレース機能SMF システム管理機能SRV ユーザー作成ルーチンへの出口OPn 特定の宛先。 n には値として 1 ～ 8 が指定可能です。

トレース・タイプごとの指定可能な宛先については、 407ページの『第 73 章-START TRACE (DB2)』のリストを参照してください。



|

|

|

|

|

|

PLAN(plan-name, ...)特定のアプリケーション・プランについて開始したトレースにリストを限定します。プラン名は 8 つまで使用できます。複数の名前を使用する場合にAUTHID、TNO、および LOCATION に使用できる値は 1 つのみです。このオプションは、STAT と同時に使用しないでください。

デフォルトは PLAN(*) で、リストの制限は行いません。

AUTHID(authorization-id, ...)特定の許可 ID について開始したトレースにリストを限定します。ID は 8 つまで使用できます。複数の ID を使用する場合に PLAN、TNO、およびLOCATION に使用できる値は 1 つのみです。このオプションは、STAT と同時に使用しないでください。

デフォルトは AUTHID(*) で、リストの制限は行いません。

CLASS(integer, ...)特定のクラスについて開始したトレースにリストを限定します。指定可能なクラスの説明については、 407ページの『第 73 章 -START TRACE (DB2)』を参照してください。

デフォルトは CLASS(*) で、リストの制限は行いません。

TNO(integer, ...)トレース番号 (1 ～ 32、01 ～ 09) によって識別される特定のトレースにリストを限定します。トレース番号は 8 つまで使用できます。複数の番号を使用する場合に PLAN、AUTHID、および LOCATION にそれぞれ使用できる値は 1

つのみです。

デフォルトは TNO(*) で、リストの制限は行いません。

LOCATION(location-name, ...)指定のロケーションとの分散関係を持つスレッドについて開始されたトレースにリストを限定します。

(location-name)指定するロケーション名は、DB2 サブシステムに割り当てられた 1 ～ 16 文字の ID であり、この DB2 サブシステムのトレースを表示することになります。ロケーション名に * を指定した場合は、任意のロケーション名修飾子で始まるトレースすべてをトレースの表示に含めることを意味します。

ロケーション名は 8 つまで指定することができます。複数のロケーション名を指定する場合に PLAN、AUTHID、および TNO にそれぞれ指定できる値は 1

つのみです。

統計トレースを選択する場合、LOCATION は指定できません。

DB2 UDB for z/OS 以外のリクエスター: DB2 は、DB2 UDB for z/OS サブシステム以外のリクエスターからのロケーション名は受け取りません。DB2 UDB

for z/OS サブシステム以外のリクエスターについての情報を表示するには、そのリクエスターの LU 名をより小 (<) とより大 (>) 記号で囲んで入力します。例えば、次のコマンドは、LULA という LU 名を持つリモート・ロケーションについての情報を表示します。

-DISPLAY TRACE (*) LOCATION (<LULA>)



DB2 では、DB2 UDB for z/OS サブシステム以外のリクエスターに関する情報を表示するメッセージには <LU> 表記を使用します。

デフォルトは LOCATION(*) で、リストの制限は行いません。

<luname>

luname に指定したリモート SNA LU を介して DDF に接続されているリモート・クライアントに対する DB2 トレースをアクティブ化します。

nnn.nnn.nnn.nnn

nnn.nnn.nnn.nnn により指定される IP アドレスを持つリモート TCP/IP ホストを介して DDF に接続されているリモート・クライアントについて、DB2 トレースをアクティブ化します。

例例 1: 汎用トレース機能を唯一の宛先としているトレースすべてをリスト表示します。

-DISPLAY TRACE (*) DEST (GTF)

例 2: START TRACE コマンドの「例 2」で開始されたトレースをリスト表示します。

-DISPLAY TRACE (ACCTG) PLAN (DSN8BC81)COMMENT (’ACCTG TRACE FOR DSN8BC81’)

例 3: アクティブなパフォーマンス・トレースすべてをリスト表示します。

-DISPLAY TRACE=P

例 4: ロケーション名 USIBMSTODB23 の DB2 サブシステムに接続されているスレッドに対するアクティブな監査トレースをすべてリストします。

-DISPLAY TRACE (AUDIT) LOCATION (USIBMSTODB23)

例 5: DISPLAY TRACE コマンドを実行した結果表示される出力は、次のような一連のメッセージです。

- 10.26.34 -DISPLAY TRACE- 10.26.34 STC 21 DSNW127I - CURRENT TRACE ACTIVITY IS -- TNO TYPE CLASS DEST QUAL- 01 STAT 01 SMF NO- 02 ACCTG 01 SMF YES- 03 PERFM 01,02,03 GTF YES- 04 AUDIT 01,02,03,04, SMF YES- 04 06,07- 05 MON 01,02,03 OP1 NO- *********END OF DISPLAY TRACE SUMMARY DATA*********- 10.26.34 STC 21 DSN9022I - DSNWVCM1 ’-DISPLAY TRACE’ NORMAL COMPLETION

- 10.28.47 -DISPLAY TRACE DETAIL(*)- 10.28.47 STC 21 DSNW127I - CURRENT TRACE ACTIVITY IS -- TNO TYPE CLASS DEST QUAL- 01 STAT 01 SMF NO- 02 ACCTG 01 SMF YES- 03 PERFM 01,02,03 GTF YES- 04 AUDIT 01,02,03,04, SMF YES- 04 06,07- 05 MON 01,02,03 OP1 NO- *********END OF DISPLAY TRACE SUMMARY DATA*********- 10.28.47 STC 21 DSNW143I - CURRENT TRACE QUALIFICATIONS ARE -



- TNO AUTHID PLAN RMID LOCATION- 01 * * *- 02 * * *- 03 USER01 * *- 04 * * 14,16,18,26 DENVER- 05 * PROG1 *- 06 * * *- ******END OF DISPLAY TRACE QUALIFICATION DATA******- 10.28.47 STC 21 DSN9022I - DSNWVCM1 ’-DISPLAY TRACE’ NORMAL COMPLETION



第 33 章 -DISPLAY UTILITY (DB2)

DB2 コマンド DISPLAY UTILITY は、ユーティリティー・ジョブの状況を表示します。状況が表示されるユーティリティー・ジョブには、データ共用グループのものが含まれます。

このコマンドからの出力は、通知メッセージのみで構成されています。コマンドに示されたジョブごとに、メッセージの 1 つのセットが戻されます。データ共用グループのユーティリティーの場合、各ユーティリティー・ジョブが実行されているシステムのメンバー名が出力結果に示されます。

画面に表示される状況は現状を表していますが、例外は、データ共用グループにおいては、コマンドを出したメンバー以外のメンバーでユーティリティーが実行されている場合です。この場合、表示される状況は最終チェックポイント時点での現状です。

省略形: -DIS UTIL


v 『環境』

v 『許可』









データ共用範囲: グループまたはメンバー。選択したオプションにより異なります。

許可不要です。


構文

�� DISPLAY UTILITY ( utility-id )partial-utility-id**

�

�

�

,

MEMBER( member-name )

��

オプションの説明次のオプションのうち少なくとも 1 つを使用しますが、同じオプションを 2 回以上使用しないでください。

(utility-id)単一のジョブをそのユーティリティー ID、つまりこのジョブの作成時に UID

パラメーターに与えられた値によって識別します。

utility-id がデフォルトにより DSNU CLIST によって作成された場合は、tso-userid.control-file-name の形式をとります。control-file-name の値のリストについては、「DB2 ユーティリティー・ガイドおよび解説書」の『DSNU コマンド・プロシージャー (CLIST) の UID パラメーター』の説明を参照してください。

ユーティリティー・ジョブの作成時に utility-id を省略した場合、utility-id がとる形式は、userid.jobname です。

(partial-utility-id*)一連のユーティリティー・ジョブを識別します。partial-utility-id の文字で始まるユーティリティー ID ごとに状況メッセージが表示されます。

例えば -DISPLAY UTILITY(ABCD*) であれば、ABCD という文字で始まる ID が付いた、DB2 が認識するユーティリティー・ジョブすべての状況が表示されます。

(*) DB2 が認識するすべてのユーティリティー・ジョブの状況を表示します。これには、データ共用グループで現在実行中のジョブも含まれます。

MEMBER (member-name, ...)指定されたユーティリティー・ジョブの表示をデータ共用グループの特定のメンバーに限定します。デフォルトでは、任意のメンバーで実行しているユーティリティー・ジョブを表示することになります。非データ共用環境では、このオプションは無視されます。

コマンドに示されたジョブごとに、メッセージの 1 つのセットが戻されます。

-DISPLAY UTILITY (DB2)


使用上の注意表示される状況: 戻されたメッセージに表示される状況は、DB2 ユーティリティー機能がコマンドを受け取った時点の状況です。実行が進行すれば当然、ユーティリティーの現在の状態と報告された状態とに相違が生じます。例えば、DISPLAY

UTILITY コマンドによって特定のユーティリティー ID がアクティブであることが示されるかもしれませんが、リクエスターがメッセージを受け取る時点ではユーティリティー・ジョブのステップが終了しており、そのユーティリティー ID がすでに DB2 に認識されなくなっている可能性があります。

コマンドの応答: データ共用環境では、メッセージ DSNU100I、DSNU105I、DSNU106I はユーティリティー・ジョブが実行中のメンバーの名前を示します。単一のメンバー名を MEMBER オプションに指定したがそのメンバーがグループに属していない場合、あるいはメンバー名のリストを MEMBER オプションに指定したがそのいずれのメンバーもグループに属していない場合には、コマンドは失敗してメッセージが出されます。

出力DISPLAY UTILITY コマンドからの出力は、通知メッセージのみで構成されています。

SHRLEVEL CHANGE または SHRLEVEL REFERENCE を指定したすべてのREORG フェーズにおける出力: SHRLEVEL CHANGE または SHRLEVEL

REFERENCE を指定したどの REORG のフェーズでも、DISPLAY UTILITY の出力は DSNU347I の中にその情報が含まれます。SHRLEVEL CHANGE を指定したどの REORG のフェーズでも、DISPLAY UTILITY の出力には、 233ページの例 4

に示されるような情報が DSNU384I に含まれます。

DEADLINE

最後に指定された DEADLINE に従ったタイム・スタンプを示します。

MAXRO

最後に指定された MAXRO に従った秒数を示します。

LONGLOG

最後に指定された LONGLOG の値に従った CONTINUE、TERM、またはDRAIN のいずれかが示されます。

DELAY

最後に指定された DELAY の値に従った秒数が示されます。

SHRLEVEL CHANGE が指定された REORG の LOG フェーズでの出力:SHRLEVEL CHANGE を指定した REORG の LOG フェーズでは、DISPLAY

UTILITY の出力には 233ページの例 4 に示すようにメッセージ DSNU383I に次のような追加情報が含まれます。

CURRENT ITERATION NUMBER

現在の反復数を示しています。

WRITE ACCESS ALLOWED IN CURRENT ITERATION

現在のログ処理の反復で書き込みアクセスが許されているかどうかにより「YES」または「NO」を示しています。


第 33 章 -DISPLAY UTILITY (DB2) 231

ITERATION BEFORE PREVIOUS ITERATION

いままでの ELAPSED TIME (経過時間) を示し、反復における NUMBER

OF LOG RECORDS PROCESSED (処理されたログ・レコード数) を示しています。現在の反復数が 1 または 2 の場合は、これらの値は 0 です。

PREVIOUS ITERATION

直前の反復の ELAPSED TIME と NUMBER OF LOG RECORDS

PROCESSED を示しています。現在の反復数が 1 の場合は、これらの値は0 です。

CURRENT ITERATION:

ESTIMATED ELAPSED TIME (推定経過時間)、ACTUAL ELAPSED TIME

SO FAR (いままでの実際の経過時間) および ACTUAL NUMBER OF LOG

RECORDS BEING PROCESSED (処理中の実ログ・レコード数) を示しています。

CURRENT ESTIMATE FOR NEXT ITERATION

次の反復について、現在の ELAPSED TIME と現在の推定 NUMBER OF

LOG RECORDS TO BE PROCESSED (処理ログ・レコード数) を示しています。

ユーティリティー処理の進捗状況: DISPLAY UTILITY コマンドは、ユーティリティーが完了した処理の見積もりをユーザーに通知します。この出力では、 233ページの例 2 に示されているように、メッセージ DSNU105I からの情報が表示され、次の内容が含まれます。

COUNT

COUNT n はユーティリティー・フェーズで処理されたページ数またはレコード数です。COUNT は、各ユーティリティーごとに異なった意味を持っています。以下のリストに示されていないユーティリティーの場合、このフィールドは無視してください。

v LOAD ユーティリティーの場合、COUNT は、そのコマンド発行時にすべてのパーティションにロード済みのレコード総数を表します。RELOAD

フェーズが開始した時点から、最初の LOAD サブタスクがこのサブタスクに割り当てられた先頭パーティションにレコードを読み込み始める時点までは、カウントはゼロです。

v CHECK INDEX、RECOVER INDEX、および REORG ユーティリティーの場合、COUNT は処理されたレコード数を表しています。CHECK

INDEX、RECOVER INDEX、および REORG ユーティリティーの場合、COUNT は処理されたページ数を表しています。DISPLAY UTILITY コマンドが他のメンバーから入力され、REORG が実行中の場合、COUNT 数は REORG BUILD または SORTBLD フェーズ内ではゼロのままです。

v COPY、MERGE COPY、RECOVER (リストア・フェーズ)、およびRUNSTATS ユーティリティーの場合、 COUNT は処理されたページ数を表しています。

v STOSPACE ユーティリティーの場合、COUNT は処理された表スペースの数または索引数を表しています。

詳しくは、「DB2 ユーティリティー・ガイドおよび解説書」を参照してください。



#

#

#

#

#

#

例例 1: 現在 DB2 が認識しているすべてのユーティリティー・ジョブの状況情報を表示します。

-DISPLAY UTILITY (*)

例 2: データ共用グループのすべてのメンバーのユーティリティー・ジョブの状況を表示します。

-DB1G DISPLAY UTILITY (*)

メンバー DB1G と DB2G のユーティリティー・ジョブを示す次の出力が生成されます。

DSNU100I -DB1G DSNUGDIS USER = SAMPIDMEMBER = DB1GUTILID = RUNTSPROCESSING UTILITY STATEMENT 1UTILITY = RUNSTATSPHASE = RUNSTATS COUNT = 0STATUS = STOPPED

DSNU100I -DB1G DSNUGDIS USER = SAMPIDMEMBER = DB2GUTILID = CHKIX1PROCESSING UTILITY STATEMENT 8UTILITY = CHECKPHASE = UNLOAD COUNT = 0STATUS = STOPPED

DSN9022I -DB1G DSNUGCC ’-DB1G DISPLAY UTILITY’ NORMAL COMPLETION

例 3: データ共用環境、メンバー DB1G 上のユーティリティーの状況を表示します。

-DB1G DISPLAY UTILITY (*) MEMBER (DB1G)

例 4: この例は、次の DISPLAY UTILITY コマンドからの出力を示しています。

-DB1G DISPLAY UTILITY(*)

DSNU105I -DB1G DSNUGDIS - USERID = SYSADM 973MEMBER = DB1GUTILID = REORGCPPROCESSING UTILITY STATEMENT 1UTILITY = REORGPHASE = LOG COUNT = 0STATUS = ACTIVE

DSNU347I -DB1G DSNUGDIS - 974DEADLINE = NONE

DSNU384I -DB1G DSNUGDIS - 975MAXRO = DEFERLONGLOG = CONTINUEDELAY = 1200 SECONDS

DSNU383I -DB1G DSNUGDIS - CURRENT ITERATION NUMBER = 4 976WRITE ACCESS ALLOWED IN THIS ITERATION = YESITERATION BEFORE PREVIOUS ITERATION:

ELAPSED TIME = 00:00:00NUMBER OF LOG RECORDS PROCESSED = 0

PREVIOUS ITERATION:ELAPSED TIME = 00:00:00NUMBER OF LOG RECORDS PROCESSED = 0

CURRENT ITERATION:ESTIMATED ELAPSED TIME = 00:00:00ACTUAL ELAPSED TIME SO FAR = 00:00:00ACTUAL NUMBER OF LOG RECORDS BEING PROCESSED = 0

CURRENT ESTIMATE FOR NEXT ITERATION:


第 33 章 -DISPLAY UTILITY (DB2) 233

ELAPSED TIME = 00:00:00NUMBER OF LOG RECORDS TO BE PROCESSED = 0

SN9022I -DB1G DSNUGCCC ’-DIS UTIL’ NORMAL COMPLETION



第 34 章 DSN (TSO)

TSO コマンド DSN を使用すれば次の DSN サブコマンドを出すことができます。v ABEND

v BIND

v DCLGEN

v END

v FREE

v REBIND

v RUN

v SPUFI

DSN セッション中に、DB2 コマンドまたはコメントを入力できます。DB2 コマンドは先頭にハイフン (-) が必ず付きます。コメントは、アスタリスク (*) を頭に付けます。

さらに、DSN セッション中に TSO コマンド (FREE、RUN、TEST、および TIME

を除く) も出すことが可能です。TSO TEST を使用してアプリケーション・プログラムをデバッグするには、このコマンドを DSN コマンドと共に実行します。例えば次のように入力します。

TEST ’prefix.SDSNLOAD(DSN)’ CP

ABEND サブコマンドは診断のためにのみ使用するものであり、IBM ソフトウェア・サポートの指示のもとでのみ使用します。このサブコマンドを使用するのは、DSN または DB2 に生じた問題を診断するときだけです。なお、パーセント・コマンドは DSN セッション中では認識されません。TSO コマンド処理プログラムだけがそれらのコマンドをサポートします。


v 『環境』






環境DSN セッションは、TSO 下においてフォアグラウンドまたはバックグラウンドのいずれかのモードで実行します。バックグラウンド・モードで実行すると、情報を訂正したり必要な別の情報を入力するためのプロンプトは出されません。

DSN セッションはさらに、フォアグラウンドまたはバックグラウンドのいずれかのモードで実行する CLIST から開始することができます。



許可DSN コマンドが必要とする許可はありませんが、サブコマンドの大部分には許可が必要です。

構文

�� DSNDSN

SYSTEM( subsystem-name )group-attachment-name

0RETRY( integer )

�

�TEST(integer) YES

GROUP( )NO

��

オプションの説明以下のいずれのオプションも必須ではありません。

SYSTEM

(subsystem-name)DB2 サブシステムの名前を指定します。

(group-attachment-name)データ共用グループのグループ接続機構の名前を指定します。

デフォルトは SYSTEM(DSN) です。この値は DB2 のインストール時に変更することができます。

RETRY(integer)DSN を発行時に、DB2 が始動していない場合、あるいはバッチ接続の数が最大数に達していた場合、DB2 サブシステムに接続を再度繰り返す回数 (整数) を指定します。再試行は 30 秒間隔で行われます。

デフォルトは RETRY(0) です。また、再試行の最大数は 120 です。

TEST(integer)そのモジュール名の最後の 2 桁 (整数) を指定して、1 つの DSN モジュールをトレースします。100 を超える数を指定すれば、すべての DSN モジュールをトレースできます。DSN トレース情報は TSO SYSTSPRT DD ステートメントに、またオプションで DSNTRACE DD ステートメントに、書き込まれます。

GROUP

(YES) 指定されたシステムがアクティブでない場合に、グループ接続処理を考慮することを指定します。

(NO) グループ接続処理を考慮しないことを指定します。

DSN (TSO)


使用上の注意DSN セッションの開始: DSN セッションを開始するには DSN コマンドを発行します。これにより、DSN サブコマンドを入力できるようになります。このセッションには次の規則が適用されます。

v フォアグラウンド操作では、端末でのプロンプト・ストリング DSN によって入力が要求されます。バックグラウンド・モードの場合、入力は SYSTSIN データ・セットから読み取られます。

v DCLGEN コマンド内に指定された、区切り文字で区切られた複数の表名の場合を除いて、小文字での入力は大文字に変えられます。

v サブコマンドのキーワードが重複して指定された場合、それらのキーワードのうち最後のものが処理されます。例えば、MEMBER(dbrm-member-name1) とMEMBER(dbrm-member-name2) の両方が BIND PLAN に指定されている場合、DB2 は後の方である MEMBER(dbrm-member-name2) を受け入れます。

v DSN セッション中に ATTENTION (PA1) が押され、TSO ユーザー・プロファイルに PROMPT が指定されていると、次のようなメッセージ DSNE005 が表示されます。EXECUTION IS INTERRUPTED, ENTER C TO CANCEL, OR ANY OTHER REPLY

TO RESUME THE subcommand SUBCOMMAND.

C を入力すると現行のサブコマンドは取り消され、現行の DB2 接続も終了します。その後、新しい接続が確立されて別の DSN プロンプトが表示されます。ATTENTION 以外の他の応答は、中断された時点から現行サブコマンドを続行させます。

DSN セッションが CLIST から開始されているか、あるいは CLIST が DSN の下で実行している場合は、メッセージ DSNE005 を受け取るために CLIST にCONTROL PROMPT を指定する必要があります。

v DSN セッション中にコマンドの処理が終わると、入力の要求がなされます。セッションが終了するまで、このサイクルが続きます。

v セッションを終了させるには、以下のいずれかを実行します。

– END サブコマンドを出す。これで制御が TSO に渡されます。

– ATTENTION を押し、もう一度 ATTENTION キーを押してメッセージに応答する。

– DSN コマンドをもう一度出す。これで古いセッションが終了し、新しいセッションが開始されます。

DSN 戻りコードの処理: DSN セッションの終了時、レジスター 15 には、セッションでどの DSN サブコマンドが使用した最大値も、または RUN サブコマンドを使って実行したどのプログラムが使用した最大値も格納されます。ランタイム環境ではその値を戻りコードとしてフォーマットすることがあります。しかし、この値は DSN によるものではありません。

例例 1: DSN セッションを開始します。DB2 に接続しようとして失敗すると、最大 5

回 (30 秒間隔で) まで再試行されることになります。

DSN SYSTEM (DB2) RETRY (5)

DSN (TSO)

第 34 章 DSN (TSO) 237

例 2: DSN セッションを開始し、プログラムを実行してからセッションを終了してTSO に戻ります。

TSO prompt : READYUSER enters: DSN SYS (SSTR)DSN prompt : DSNUSER enters: RUN PROGRAM (MYPROG)DSN prompt : DSNUSER enters: ENDTSO prompt : READY

DSN (TSO)


第 35 章 DSNC (CICS 接続機能)

CICS 接続機能の DSNC コマンドを用いると、CICS から DB2 コマンドを入力することができます。


v 『環境』

v 『許可』

v 『構文』




環境このコマンドは、CICS 端末からのみ発行できます。


許可このコマンドは、適切なレベルの CICS 権限が必要です。これについては、該当の「CICS Transaction Server for z/OS CICS-RACF Security Guide」または「CICS

Transaction Server for z/OS 操作およびユーティリティーの手引き」に記載があります。

DSNC コマンドを入力するにあたって、DB2 セキュリティーの点からの特権は不要です。DSNC コマンドを使用して DB2 コマンドを出すのに必要な特権についての説明は、そのコマンドの説明を参照してください。

構文

�� DSNC db2-commanddestination

��

オプションの説明destination

表示情報を受け取る別の端末を識別します。この端末は CICS に対して定義され、CICS 基本マッピング・サポート (BMS) によってサポートされた有効な端末でなければなりません。


db2-command

CICS 端末から入力したい DB2 コマンドを正確に指定します。先頭にハイフンを指定する必要があります。

使用上の注意画面のスクロール: CICS SIT 表キーワード SKRxxxx を使用すれば、端末からのDSNC DB2 コマンドのスクロールがサポートされます。SIT キーワードとパラメーターについて詳しくは、「CICS Transaction Server for z/OS System Definition

Guide」を参照してください。

例例: DB2 コマンド DISPLAY THREAD を CICS 端末から出します。

DSNC -DISPLAY THREAD

DSNC (CICS)


第 36 章 DSNC DISCONNECT (CICS 接続機能)

CICS 接続機能コマンド DSNC DISCONNECT は、スレッドを切断するときに使用します。

このコマンドを用いると、通常のトランザクションによって共用されているリソースの解放を手動で制御できるため、ユーティリティーのような特殊目的の処理が排他的にリソースにアクセスすることができます。

省略形: DSNC DISC


v 『環境』

v 『許可』

v 『構文』






許可このコマンドには適切なレベルの CICS 権限が必要であり、これについては、「CICS Transaction Server for z/OS CICS-RACF Security Guide」を参照してください。

構文

�� DSNC DISCONNECT plan-name ��

オプションの説明plan-name

有効なアプリケーション・プランを指定します。


使用上の注意スレッドの作成防止: DSNC DISCONNECT コマンドを使用しても、トランザクションのためのスレッドの作成を防ぐことにはなりません。このコマンドは単に現在接続中のスレッドを、トランザクションがそれを使用しなくなった時点で終了させるだけです。トランザクションに割り込んでスレッドを早く取り消すには、DB2 コマンド CANCEL THREAD を使用できます。詳しくは、 107ページの『第 16 章-CANCEL THREAD (DB2)』を参照してください。

TRANCLASS に MAXACTIVE 設定値を指定することで、CICS において特定のプラン ID に関連するトランザクションを停止することができます。このコマンドによって、トランザクションの新しいインスタンスがスレッドを再度作成することはなくなります。

保護スレッドの場合の代替: データベースに対し、ユーティリティーの再バインド・プランまたは実行プランの割り振りを解除することができます。保護スレッドを使用している場合には、DSNC DISCONNECT ではなく DSNC MODIFY を使用してください。そのプランの THRDA 値をゼロに修正して、すべてのスレッドをプールに送るようにしてください。保護スレッドは 60 秒以内に自己終了するため、DISCONNECT は不要です。

例PLAN1 のアクティブ・スレッドを切り離します。

DSNC DISCONNECT PLAN1

DSNC DISCONNECT (CICS)


|

第 37 章 DSNC DISPLAY (CICS 接続機能)

CICS 接続機能コマンド DSNC DISPLAY は、DB2 データにアクセスする CICS トランザクションに関する情報、または DB2ENTRY と DB2CONN に関連した統計情報を表示します。

省略形: DSNC DISP


v 『環境』

v 『許可』

v 『構文』







許可このコマンドは、適切なレベルの CICS 権限が必要です。これについては、「CICS

Transaction Server for z/OS CICS-RACF Security Guide」または「CICS Transaction

Server for z/OS 操作およびユーティリティーの手引き」に記載があります。

構文

�� DSNC DISPLAY PLANplan-name

TRANSACTIONtransaction-id

STATISTICS

destination��

オプションの説明PLAN plan-name

トランザクションに関する情報をプラン名別に表示します。

plan-name は、情報が表示される有効なプラン名です。


|

デフォルト: plan-name を指定しない場合 (またはアスタリスク (*) を指定した場合) は、すべてのアクティブ・トランザクションに関する情報が表示されます。

TRANSACTION transaction-id

トランザクションに関する情報をトランザクション ID 別に表示します。

省略形: TRAN

transaction-id は、情報の表示対象の有効なトランザクション ID です。

デフォルト: トランザクション ID を指定しない場合は、すべてのアクティブ・トランザクションに関する情報が表示されます。

STATISTICS各 DB2ENTRY に関連した統計カウンターの 1 行を表示します。このカウンターは DB2 に対する CICS 接続機能の使用可能な接続の使用状況に対応します。

省略形: STAT

CICS からこのコマンドを出した時点で、CICS 接続機能がアクティブで、DB2

サブシステムがアクティブでない場合、DB2 サブシステムが操作可能でないことを明確に示さない統計表示を作成します。 CICS メッセージ・ログにメッセージ DFHDB2037 が表示され、接続機能が DB2 の開始を待っていることを示します。

このパラメーターによって作成される出力の説明については、「DB2 管理ガイド」第 4 部 (第 1 巻) を参照してください。

destination

要求された表示情報を受け取る別端末の ID を指定します。この端末は CICS

に対して定義され、CICS 基本マッピング・サポート (BMS) によってサポートされた有効な端末でなければなりません。

使用上の注意パラメーターの入力: このコマンドでは、オプションの宛先の前にオプションのプラン名またはトランザクション ID が指定されていることがあります。このため、各パラメーターは固有であり、名前または端末 ID として別々に識別できる必要があります。入力されるパラメーターが 1 つだけである場合には、まず最初にそれがプラン名とトランザクション ID のいずれであるかが調べられ、その後で宛先として調べられます。プラン名またはトランザクション ID であり、さらに有効な端末ID でもある文字ストリングを使用するには、希望する端末で希望する情報を表示させるために、名前と宛先の両方のパラメーターを使用する必要があります。

代替宛先へ送信される表示情報の確認: 要求された表示情報を受け取る代替宛先が指定されている場合、次のメッセージが要求端末に送信されます。

DFHDB2032 THE DISPLAY COMMAND IS COMPLETE

DSNC DISPLAY (CICS)


|

|

|

|

|

|

|

出力作成された各スレッドごとに、246 ページの例 2 に示されている DSNC

DISPLAY (PLAN または TRANSACTION) コマンドの出力は、以下の情報を表示します。

DB2ENTRY DB2ENTRY の名前です (プールの場合は *POOL、または DSNC

コマンド呼び出しの場合は *COMMAND)。

S 状況フィールド。「A」の状況は、そのスレッドが作業単位内でアクティブであることを示します。「I」の状況は、保護スレッドが処理を待っていることを示します。

PLAN スレッドに関連したプランです。コマンド・スレッドはプランを持っていません。

PRI -AUTH スレッドの 1 次許可 ID です。

SEC -AUTH スレッドの 2 次許可 ID です (存在する場合)。

CORRELATIONeeeettttnnnn 形式の 12 バイトのスレッド相関 ID です。ここで、eeee は、COMD、POOL、または ENTR (コマンド、プール、または DB2ENTRY スレッドを示す) のいずれかであり、tttt はトランザクション ID、nnnn は固有の番号です。

スレッドが作業単位内でアクティブの場合、その CICS トランザクション名(TRAN)、タスク番号 (TASK)、および CICS ローカル作業単位 ID (UOW-ID) も表示されます。

DSNC DISPLAY STATISTICS コマンドの出力 ( 247ページの例 4 を参照) は、以下の情報を表示します。

DB2ENTRY DB2ENTRY の名前です (DSNC コマンドの場合は *COMMAND、またはプール統計の場合は *POOL)。

PLAN この項目に関連したプラン名です。このフィールドに 8 個のアスタリスクが表示されている場合は、該当するトランザクションが動的プラン割り振りを使用していることを示します。また、コマンド処理プログラム・トランザクション DSNC はコマンド処理プログラムを使用しているため、それに関連したプランはありません。

CALLS この項目に関連したトランザクションが発行した SQL ステートメントの合計数です。

AUTHS この項目に関連したトランザクションに対するサインオン呼び出しの合計数です。サインオンは、新しいスレッドが作成されたか、あるいは既存のスレッドが再利用されたかを示すものではありません。スレッドが再利用された場合、サインオンが生じるのは許可 ID

またはトランザクション ID に変更があったときだけです。

W/P この項目の使用可能なすべてのスレッドが使用中であった回数です。この値は、項目の THREADWAIT の値によって異なります。

プールへのオーバーフローはトランザクションの統計にのみ示され、プールの統計には反映されません。

DSNC DISPLAY (CICS)

第 37 章 DSNC DISPLAY (CICS 接続機能) 245

|

|

|

||

|

||

|

|

||

|

||

||

|

|

|

|

|

|

|

|

|

||

|

|

|

THREADWAIT が YES に設定されている場合、スレッドが待機する必要があった回数が出力に反映されます。開始済みタスクの数がTHREADLIMIT に達した場合、スレッドが新規サブタスクに接続できなかった回数も出力に反映されます。

プールについて W/P の更新が行われるのは、トランザクションがプール・スレッドを待たなければならず、かつ新しいサブタスクがそのプールに接続できなかった時だけです。W/P の統計は、項目に定義されているスレッドの数が十分かどうかを判別するのに役立ちます。

HIGH 接続の開始以降の任意の時点で、この項目に関連するトランザクションが必要とした最大スレッド数です。この数字を基準にして、項目の最大スレッド数を設定することができます。リリース 1.2 より前の CICS Transaction Server リリースの場合、この数値には、強制的に待機させられたトランザクション、またはプールに迂回させられたトランザクション数も含まれます。リリース 1.2 以降の場合、HIGH キーワードは、その項目に関して実際に作成されたスレッドにのみ関連付けられます。

ABORTS ロール・バックされたリカバリー単位の合計数です。異常終了とSYNCPOINT ROLLBACKS (-911 SQL コードが生成したSYNCPOINT ROLLBACKS を含む) の両方がこれに含まれます。

COMMITS この項目に関連付けられた DB2 トランザクションが実同期点または暗黙の (EOT など) 同期点に達するたびに、次の 2 つのフィールドの一方の値が増加します。SQL 呼び出しを処理しないリカバリー単位は、ここには反映されません。

1-PHASE この項目に関連したトランザクションに対する 1 フェーズ・コミットの合計数です。この合計数には 2 フェーズ・コミットはまったく含まれていません (次の 2-PHASE の項の説明を参照)。しかし、この合計数には、読み取り専用コミットと、更新を実行したリカバリー単位の 1 フェーズ・コミットもこれに含まれます。 2 フェーズ・コミットが必要となるのは、CICS が複数のリソース・マネージャー用のリカバリー・コーディネーターとなっている場合だけです。

2-PHASE この項目に関連したトランザクション別の 2 フェーズ・コミット合計数です。この数には、1 フェーズ・コミットのトランザクションは含まれていません。

例例 1: このコマンドは、すべてのアクティブ・スレッドに関する情報を表示します。表示情報は、MTO2 と指定された別端末に送信されます。

DSNC DISP PLAN * MTO2

例 2: この例は、DSNC DISPLAY (PLAN または TRANSACTION) コマンドの出力を示します。

DFHDB2013 07/09/98 15:26:47 IYK4Z2G1 DISPLAY REPORT FOLLOWS FOR THREADSACCESSING DB2 DB3A

DSNC DISPLAY (CICS)


|

|

|

|

|

|

|

|

|

|

|

|||

DB2ENTRY S PLAN PRI-AUTH SEC-AUTH CORRELATION TRAN TASK UOW-ID*POOL A TESTC05 JTILLI1 POOLXC050001 XC05 01208 AEEEC03-1ACDCE00XC06 A TESTC06 JTILLI1 ENTRXC060003 XC06 01215 AEEEC04-2F8EFE01XP05 A TESTP05 JTILLI1 ENTRXP050002 XP05 01209 AEEEC03-35230C00XP05 I TESTP05 JTILLI1 ENTRXP050004DFHDB2020 07/09/98 15:26:47 IYK4Z2G1 THE DISPLAY COMMAND IS COMPLETE.

例 3: このコマンドは、DB2ENTRY に関連した統計カウンターを表示します。

DSNC DISP STAT

例 4: この例は DSNC DISPLAY STATISTICS コマンドの出力例です。

DFHDB2014 07/09/98 14:35:45 IYK4Z2G1 STATISTICS REPORT FOLLOWS-----COMMITS-----

DB2ENTRY PLAN CALLS AUTHS W/P HIGH ABORTS 1-PHASE 2-PHASE*COMMAND 1 1 1 1 0 0 0*POOL POOL 0 0 0 0 0 0 0XC01 DSNXC01 22 1 11 2 0 7 5XC02 DSNXC02 0 0 0 0 0 0 0XA81 DSNA81 0 0 0 0 0 0 0XCD4 DSNCED4 0 0 0 0 0 0 0XP03 DSNTP03 1 1 0 1 0 1 0XA20 DSNTA20 1 1 0 1 0 0 1XA88 ******** 0 0 0 0 0 0 0DFHDB2020 07/09/98 15:45:27 IYKA4z2G1 THE DISPLAY COMMAND IS COMPLETE

DSNC DISPLAY (CICS)

第 37 章 DSNC DISPLAY (CICS 接続機能) 247

||||||

|

|||||||||||||

DSNC DISPLAY (CICS)


第 38 章 DSNC MODIFY (CICS 接続機能)

CICS 接続機能コマンド DSNC MODIFY は、次のものを変更します。

v DB2CONN のメッセージ・キュー宛先

v プール、DSNC コマンド、または DB2ENTRY の最大アクティブ・スレッド値

省略形: DSNC MODI


v 『環境』

v 『許可』

v 『構文』








構文

�� DSNC MODIFY DESTINATION old newTRANSACTION transaction-id integer

��

オプションの説明DESTINATION

DB2CONN の MSGQUEUE パラメーターを変更して、 old 宛先 ID を new 宛先 ID で置き換えることを指定します。

省略形: DEST


|

|

|

old

DB2CONN の MSGQUEUE 内で現在アクティブになっている宛先 ID を識別します。

new

新しい宛先 ID を指定します。CICS は、新しい宛先を検査して、それが、宛先管理テーブル一時データ・エントリーであることを確認します。

TRANSACTION指定されたトランザクションまたはグループに関連したアクティブ・スレッドの最大値を変更することを指定します。

省略形: TRAN

transaction-id

有効なトランザクション ID を指定します。

最大アクティブ・スレッド値を変更するには、以下のトランザクション ID

のいずれかを使用します。

v プールの場合: CEPL

v コマンド・スレッドの場合: DSNC

v DB2ENTRY の場合: DB2ENTRY を使用するように定義されたトランザクションの ID

integer

新しい最大値を指定します。

使用上の注意保護スレッド: コマンド DSNC MODIFY TRANSACTION を使用してアクティブ・スレッド値を増やす場合は、DB2ENTRY の属性を使用します。

DSNC MODIFY TRANSACTION を発行して許容スレッドの合計数を増やすと、非保護スレッドを作成できます。例えば、PROTECTNUM(2) と THREADLIM(2) であるとします。許容スレッドの合計数が増えると、追加のスレッドは非保護になります。

コマンド DSNC MODIFY TRANSACTION を使用すれば、保護スレッドの作成が可能になります。PROTECTNUM(2) と THREADLIM(2) のときに、スレッド限度を 1

に変更すると、保護スレッドが除去されます。次に、スレッド限度を 2 に戻すと、再作成されるスレッドは保護スレッドになります。

TRANSACTION スレッド限度: 指定可能な最低値はゼロです。

例例 1: DB2CONN の MSGQUEUE パラメーターの指定を MTO1 から MTO2 に変更します。

DSNC MODIFY DESTINATION MTO1 MTO2

例 2: プール・スレッド限度を 12 に変更します。

DSNC MODIFY TRANSACTION CEPL 12


|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

例 3: コマンド・スレッド限度を 3 に変更します。

DSNC MODIFY TRANSACTION DSNC 3

例 4: トランザクション XP05 によって使用される DB2ENTRY のスレッド限度を8 に変更します。

DSNC MODIFY TRANSACTION XP05 8

第 38 章 DSNC MODIFY (CICS 接続機能) 251

|

|

|

|

|

第 39 章 DSNC STOP (CICS 接続機能)

CICS 接続機能コマンド DSNC STOP は、接続機能を停止します。


v 『環境』

v 『許可』

v 『構文』








構文

�� DSNC STOPQUIESCEFORCE ��

オプションの説明QUIESCE現在実行中の CICS トランザクションが終了した後、CICS 接続機能が停止するよう指定します。

省略形: Q

FORCE実行中のトランザクションに関係なく、DB2 を強制的に切断して CICS 接続機能を即座に停止するよう指定します。


使用上の注意再始動要件: FORCE を使用すると、スレッドは未確定状態のままになる可能性があります。再始動するためには、CICS と DB2 を再接続させて未確定状態を解決する必要があります。データ共用環境、未確定状態を解決するためには CICS を同じDB2 メンバーに再接続する必要があります。

出力の宛先: コマンド DSNC STOP からの出力は、要求端末に送られ、端末はシャットダウンが完了するまでロックされたままになります。

例CICS 接続機能を停止します。

DSNC STOP FORCE

DSNC STOP (CICS)


|

|

第 40 章 DSNC STRT (CICS 接続機能)

DSNC STRT コマンドは CICS 接続機能を開始して、CICS アプリケーション・プログラムによる DB2 データベースへのアクセスを可能にします。


v 『環境』

v 『許可』

v 『構文』








構文

�� DSNC STRTssid

��

オプションの説明ssid

CICS DB2CONN で指定された ID をオーバーライドするためのサブシステムID (SSID) を指定します。

デフォルト: 最後にインストールされた DB2CONN で指定されたDB2ID。DB2CONN にブランク DB2ID が含まれている場合、デフォルトはCICS INTIPARM パラメーターで指定された SSID になります。


|

|||||||||||||

|

|

|

|

|

|

使用上の注意出力の宛先: コマンド DSNC START からの出力は要求端末に送られます。DSNC

STRT 発行時に DB2CONN がインストールされていない場合、エラー・メッセージDFHDB2031 が端末に送信されます。

例例 1: CICS 接続機能を開始します。

DSNC STRT

例 2: CICS 接続機能を開始します。DB2CONN で指定された SSID を DB2P でオーバーライドします。

DSNC STRT DB2P

例 3: CICS 接続機能を開始します。SSID DBA1 を使用します。

DSNC STRT DBA1

DSNC STRT (CICS)


|

|

|

|

|

|

|

|

|

|

第 41 章 DSNH (TSO CLIST)

DSNH コマンド・プロシージャー (TSO CLIST) は強力でありながら、アプリケーション・プログラムを作成し、実行する方法としては簡単です。コマンドを 1 つ出すだけで、アプリケーションの作成に必要な多数のオプションを選び、それを TSO

下で実行することができます。

DSNH 処理は、2 文字のステップ名で参照されるすべてのアクション (表 19 にリストされている) 組み込める順次処理です。

表 19. DSNH アクションおよび対応するステップ名

呼び出しの対象使用するステップ名

PL/I マクロ処理プログラム MP

DB2 プリコンパイラー PC

CICS コマンド言語翻訳プログラム TR

プランをバインドする DSN BIND PLAN サブコマンド BI

パッケージをバインドする DSN BIND PACKAGE サブコマンド BP

プログラム用のコンパイラーまたはアセンブラー CO

コンパイル時パラメーターを組み込むための C コンパイラー・プリリンク・ユーティリティー

PL

実行可能ロード・モジュールを作成するリンケージ・エディター LE

プログラムを実行する DSN RUN サブコマンド RU

注: このステップ名は 259ページの表 21 の見出しで使用されています。

個々のステップまたは一連のステップを実行することができ、また処理は任意の時点で終了することができます。処理のステップをスキップする場合は、DSNH により前もって正常に完了しておく必要があります。アプリケーション・プログラムを実行するための準備に関するガイドについては、「DB2 アプリケーション・プログラミングおよび SQL ガイド」を参照してください。 DSN BIND サブコマンドの説明については、 21ページの表 1 を参照してください。





v 258ページの『DSNH CLIST パラメーターの要約』

v 262ページの『一般パラメーターの説明』

v 278ページの『DSNH/DSN サブコマンドの要約』

v 278ページの『DSNH CLIST/BIND PLAN サブコマンドの比較』

v 282ページの『DSNH CLIST/BIND PACKAGE サブコマンドの比較』




環境DSNH CLIST の実行は、TSO フォアグラウンドで、または TSO 端末モニター・プログラム下のバッチで行うことができます。DB2I はプリコンパイラー・パネルでDSNH CLIST を使用し、プログラムの作成を制御することができます。「Other

options」行に DB2I パネルからの DSNH パラメーターを渡すことができます。


許可パッケージのバインドに必要な特権については、 55ページの『第 13 章 BIND

PACKAGE (DSN)』を参照してください。

プランのバインドに必要な特権については、 63ページの『第 14 章 BIND PLAN

(DSN)』を参照してください。

プランの実行に必要な特権については、 355ページの『第 59 章 RUN (DSN)』を参照してください。

構文

�� DSNH INPUT(data-set-name)

� clist-parameter

��

DSNH CLIST パラメーターの要約CLIST パラメーターは、各ステップの処理オプションを指定するためのものです。DSNH 実行時に、それらのオプションを指定してください。 259ページの表 21 に示されているように、複数のステップに使用されるパラメーターもあります。 259

ページの表 21 では、各パラメーターを使用する場所を次の表記法で示しています。v セル内の Y は、行の先頭にリストされたオプションが、その列の最上部にある名前のステップで使用されることを示しています。

v セル内の * は、行の先頭にリストされたオプションが、その列の最上部にある名前のステップに影響を与える別のステップで使用されることを示しています。

BIND PLAN および BIND PACKAGE ステップの CLIST パラメーターの表記法:BIND PLAN と BIND PACKAGE のパラメーターの多くは同じ機能を持ち、またスペルも似ています。BIND PLAN および BIND PACKAGE の CLIST パラメーターは、接頭部を指定することで一般のパラメーターと区別され、また相互に区別されます。接頭部が B の文字のパラメーター名は BIND PLAN サブコマンドに適用され、接頭部が P の文字のパラメーター名は BIND PACKAGE に適用されます。259ページの表 20 には、単一のパラメーター名に対して指定可能なバリエーションが示されています。

DSNH (TSO CLIST)


表 20. DSNH CLIST プレフィックス変換規則

パラメーター値機能またはサブコマンド例

parameter 接頭部が指定されない場合、パラメーターは単一の機能またはサブコマンドに適用されます。

DBRMLIB

B/parameter 接頭部 B を使用した場合、パラメーターのこのバリエーションが BIND PLAN ステップのみに適用されることを示します。

B/DBRMLIB

P/parameter 接頭部 P を使用した場合、パラメーターのこのバリエーションは BIND PACKAGE ステップのみに適用されることを示します。

P/DBRMLIB

表 21 では、接頭部はスラッシュ (/) によって DB2 パラメーター名と区切られます。2 文字ステップ名の説明については、 257ページの表 19 を参照してください。

表 21. DSNH CLIST パラメーターの要約OPTIONS MP PC TR BI BP CO PL LE RU

ACQUIRE Y *

P/ACTION Y Y

ASMLIB Y

ASMLOAD Y

P/BDMEM Y Y

P/BIND Y Y

P/BLIB Y

P/BnLIB Y

P/BMEM Y Y

CACHESIZE Y

CCLINK Y

CCLLIB Y

CCLOAD Y

CCMSGS Y Y

CCOLIB Y

CCPLIB Y

CCPMSGS Y

CCSID Y

CCSLIB Y

P/CICS Y Y

CICSCOB Y Y

CICSLLIB Y Y

CICSOPT Y

CICSPRE Y Y

CICSPLIB Y Y

CICSVER Y Y

CICSXLAT Y

CLIB Y Y

CnLIB Y Y

COBICOMP Y

COBILINK Y

DSNH (TSO CLIST)

第 41 章 DSNH (TSO CLIST) 259

|

表 21. DSNH CLIST パラメーターの要約 (続き)

OPTIONS MP PC TR BI BP CO PL LE RU

COBIPLNK Y

COBIPMSG Y

COBLIB Y

COBLOAD Y

COBSOM Y

COB2CICS Y

COB2LIB Y

COB2LOAD Y

COMPILE Y

CONNECT Y

CONTROL Y Y * Y Y Y

COPTION Y Y

COPY Y

COPYVER Y

CPPCLASS Y

CPPCLINK Y

CPPCLLIB Y

CPPCSLIB Y

CPPLLIB Y

CPPPMSGS Y

CPPSLIB Y

CPPUTIL Y

CURRENTDATA Y Y

CURRENTSERVER Y

DATE Y

P/DBPROTOCOL Y Y

P/B/DBRMLIB Y Y Y

DECARTH Y

DECIMAL Y *

P/DEFER Y Y

P/DEGREE Y Y

DELIMIT Y Y Y

P/DISABLE Y Y

DISCONNECT Y -

P/DLIBATCH Y Y

P/DYNAMICRULES Y Y

P/ENABLE Y Y

ENTRY Y

EXPLAIN Y Y

P/FLAG Y Y Y Y Y Y

FORTLIB Y

FORTLOAD Y

GRAPHIC Y

HOST Y Y Y * Y Y Y

P/IMSBMP Y Y

DSNH (TSO CLIST)




P/IMSMPP Y Y

IMSPRE Y

INPUT Y Y * * Y Y Y

P/ISOLATION Y Y

P/KEEPDYNAMIC Y Y

LINECOUNT Y Y Y Y

LINK Y

LLIB Y

LnLIB Y

LOAD Y Y

LOPTION Y

MACRO Y Y

NEWFUN Y

NOFOR Y

P/NODEFER Y Y

P/OPTHINT Y Y

OPTIONS Y Y Y Y

OUTNAME Y Y Y Y Y

P/OWNER Y Y

PACKAGE Y

PARMS Y

PASS Y

P/PATH Y Y

PCLOAD Y

PKLIST Y

PLAN Y Y

PLIB Y

PnLIB Y

PLI2LIB Y

PLILIB Y

PLILOAD Y Y

PLIPLNK Y

PLIPMSG Y

POPTION Y

PRECOMP Y

PRELINK Y

PRINT Y Y Y Y Y

PSECSPAC Y Y Y Y Y

PSPACE Y Y Y Y Y

P/QUALIFIER Y Y

RCTERM Y Y Y Y Y Y Y Y

P/RELEASE Y Y

REMOTE Y

P/REOPT Y Y

REPLVER Y

DSNH (TSO CLIST)


|



RETAIN Y

RUN Y Y Y Y

RUNIN Y

RUNOUT Y

SOMDLLI Y Y

SOURCE Y Y Y Y

SPACEUN Y Y Y Y Y

SQL Y

SQLDELIM Y

SQLERROR Y

SQLRULES Y

STDSQL Y

SUFFIX Y Y

SYSTEM * * Y

TERM Y Y Y Y

TIME Y

P/VALIDATE Y Y

VERSION Y

WORKUNIT Y Y Y Y

WSECSPAC Y Y Y Y

WSPACE Y Y Y Y

XLIB Y

XREF Y Y Y Y

一般パラメーターの説明BIND PLAN および BIND PACKAGE の CLIST パラメーターは、名前および機能が似ているために、表 22 のパラメーターとは切り離して説明されています。各パラメーターについての要約は、以下の箇所に記載されています。v BIND PLAN パラメーターについては、 278ページの表 23 を参照してください。

v BIND PACKAGE パラメーターについては、 282ページの表 24 を参照してください。

さらに、これらの表で使用される規則については、 278ページの『DSNH/DSN サブコマンドの要約』を参照してください。

DSNH ステートメントで必要となる唯一のパラメーターは INPUT で、その他はオプションです。 263ページの表 22 にその一覧を記載します。

v パラメーター値は括弧で囲む必要があります。

v パラメーター値はアポストロフィで囲む必要はありません。ただし、以下の場合を除きます。

– 値が区切り文字付きトークンのリストの場合は、その値をアポストロフィで囲む必要があります。

DSNH (TSO CLIST)


– 値がデータ・セット名の場合は、ユーザー ID を接頭部として追加します。接頭部を使用したくない場合は、データ・セット名を 3 つのアポストロフィのセットで囲みます。

v 大部分のパラメーター値は、データ・セット名 (dsname) である場合はメンバー名を組み込むことはできません。例外については、パラメーターの説明に記載されています。

v 下線付きの値はデフォルトです。デフォルト名は、DB2 のインストール時に各サイトに特有の名前に変更することができます。

表 22. DSNH CLIST の一般パラメーター

パラメーター値コメント

ASMLIB dsname 使用するデータ・セットを、高水準アセンブラー用の標準 MACLIB として指定します。

デフォルトは ‘‘‘SYS1.MACLIB’’’ です。

ASMLOAD dsname 高水準アセンブラーのロード・モジュールを入れるデータ・セットを指定します。

dsname にはメンバー名を組み込むことができます。

デフォルトは ‘‘‘SYS1.LINKLIB(ASMA90)’’’ です。

CCLINK dsname C プログラムの作成に使用する IBM Language Environment® プリリンク・エディター・ユーティリティーの呼び出しロード・モジュールを入れるデータ・セットを指定します。


デフォルトは ‘‘‘CEE.SCEERUN(EDCPRLK)’’’ です。

CCLLIB dsname C コンパイラー・ルーチンのリンケージ・エディター組み込みモジュールを入れるデータ・セットを指定します。

デフォルトは ‘‘‘CEE.SCEELKED’’’ です。

CCLOAD dsname C コンパイラー呼び出しロード・モジュールを入れるデータ・セットを指定します。


デフォルトは ‘‘‘CBC.SCCNCMP(CCNDRVR)’’’ です。

CCMSGS dsname C コンパイラー・メッセージを入れるデータ・セットを指定します。このデータ・セットは C/370 の場合にのみ必要です。


デフォルトは ‘‘‘EDC.V1R2M0.SEDCDMSG(EDCMSGE)’’’ です。

CCSID integer ソース SQL ステートメント用の CCSID を整数で指定します。CCSID パラメーターの詳細については、「DB2 アプリケーション・プログラミングおよび SQL ガイド」のプリコンパイラー・オプションの説明を参照してください。

CCOLIB NONE

dsname

C オブジェクト・モジュールを含むデータ・セットが、プリリンク・ユーティリティー・ステップの実行中に組み込まれることを指定します。

DSNH (TSO CLIST)


|||||

表 22. DSNH CLIST の一般パラメーター (続き)


CCPLIB NONE

dsname

PL/I ルーチン用の組み込みモジュールを入れるデータ・セットを指定します。このパラメーターは IBM C/370 第 2 版以前にだけ使用されます。

CCPMSGS dsname C プログラムを作成するときに IBM プリリンク・エディターが使用するメッセージ・ライブラリーを入れるデータ・セットを指定します。

デフォルトは ‘‘‘CEE.SCEEMSGP(EDCPMSGE)’’’ です。

CCSLIB dsname C コンパイラー・ヘッダーを入れるデータ・セットを指定します。

デフォルトは ‘‘‘CEE.SCEEH.H’’’ です。

CICSOPT NONE

option-list

追加の CICS 変換プログラム・オプションのリストを指定します。変換プログラム・オプションについては、該当する CICS アプリケーション・プログラミング解説書を参照してください。

デフォルトの NONE には追加オプションはありません。

CICSPRE prefix CICS ライブラリーの接頭部を指定します。ライブラリー名は次のとおりです。

prefix.LOADLIB (変換プログラムの場合)

prefix.PL1LIBn (PL/I 組み込みの場合)

prefix.COBLIB (COBOL 組み込みの場合)

CICSLLIB、CICSPLIB、CICSCOB を使用するには、このパラメーターをブランクにしておきます。

デフォルトはブランクです。

CICSLLIB dsname CICS ロード・ライブラリーを指定します。このライブラリーを使用するには、CICSPRE パラメーターをブランクにしておきます。

デフォルトは、インストール・パネル DSNTIP3 上で設定します。

CICSPLIB dsname CICS PL/I ライブラリーを指定します。このライブラリーを使用するには、CICSPRE パラメーターをブランクにしておきます。


CICSCOB dsname CICS COBOL ライブラリーを指定します。このライブラリーを使用するには、CICSPRE パラメーターをブランクにしておきます。


CICSVER 21

31

33

41

CICS リリースを指定します。現行リリースの CICS では、DSNH を使用しなくてもリリース固有の考慮事項を処理できるので、このフィールドは無視されます。

CICSXLAT NO

YES

CICS コマンド変換プログラムを実行するかどうかを指定します。このパラメーターは、RUN(CICS) を使用する場合のみ有効です。また、このパラメーターを使用する際に、変換プログラムの MARGINS オプションを指定することはできません。

デフォルトは YES です。また、DB2I パネルのデフォルトは NO です。

DSNH (TSO CLIST)




CLIB

CnLIB

NONE

dsname

コンパイラーまたはアセンブラーによって組み込まれる、ホスト言語のソース・ステートメントを入れるデータ・セットを指定します。パラメーターCnLIB (ここで、n には 2、3、4 のいずれかを指定できます) は CLIB の拡張で、データ・セット名一覧の受け渡し方法を単純化するのに使用します。

指定するデータ・セットがない場合は、デフォルトの NONE を使用します。

COBICOMP dsname コンパイルに必要な IBM COBOL データ・セットを指定します。

デフォルトは ‘‘‘IGY.SIGYCOMP’’’ です。

COBILINK dsname リンク・エディットに必要な IBM COBOL データ・セットを指定します。


COBIPLNK dsname COBOL プログラムの作成に使用する IBM Environment プリリンク・エディター・ユーティリティーの呼び出しロード・モジュールを入れるデータ・セットを指定します。



COBIPMSG dsname COBOL プログラム作成時に IBM プリリンク・エディターが使用するメッセージ・ライブラリーを入れるデータ・セットを指定します。



COBLIB dsname OS/VS COBOL ルーチンに使用されるリンケージ・エディター組み込みライブラリーを指定します。

このパラメーターは使用されなくなりました。

COBLOAD dsname OS/VS COBOL コンパイラーのロード・モジュールを入れるデータ・セットを指定します。


COBSOM dsname SOM オブジェクトにアクセスするために必要な IBM System Object Model®

(SOM®) データ・セットを指定します。


COB2CICS dsname VS COBOL II CICS ルーチンに使用されるリンケージ・エディター組み込みライブラリーを指定します。


COB2LIB dsname VS COBOL II または COBOL/370 ルーチンに使用されるリンケージ・エディター組み込みライブラリーを指定します。


COB2LOAD dsname VS COBOL II または COBOL/370 コンパイラーのロード・モジュールを入れるデータ・セットを指定します。


DSNH (TSO CLIST)




COMPILE YES

NO

プリコンパイル・ステップが正常に終了したらコンパイラーまたはアセンブラーを実行するかどうかを指定します。

CONNECT (1)

(2)

CONNECT SQL ステートメントが、タイプ 1 CONNECT とタイプ 2

CONNECT のどちらのステートメントとして処理されるべきかを指定します。DSNH(TSO CLIST) コマンドは、このプリコンパイラー・オプションのCT(1) および CT(2) 省略形を受け入れません。

デフォルトは CONNECT(2) です。

CONTROL NONE

CONLIST

LIST

SYMLIST

実在しないデータ・セット割り振りをトレースできるように指定します。問題の原因がはっきりしない場合は、このパラメーターを使用します。

CONLIST は、記号の置き換えからコマンドの実行までの CLIST コマンドを表示します。

LIST は、記号の置き換えからコマンドの実行までの TSO コマンドを表示します。

SYMLIST は、記号の置き換え前のすべての実行可能ステートメント (TSO

コマンドと CLIST ステートメント) を表示します。

COPTION NONE

string

コンパイラー・オプションまたはアセンブラー・オプションのリストを指定します。詳細については、特定の言語用のコンパイラー・オプションまたはアセンブラー・オプションについて説明した資料を参照してください。一部のオプションにおける制約事項については、 285ページのCOBOL オプションの一覧を参照してください。

NONE はオプションを指定しません。

CPPCLASS dsname C++ クラス・ライブラリーを含むデータ・セットを指定します。

デフォルトは ‘‘‘CBC.SCLBCPP’’’ です。

CPPCLINK dsname C プログラムの作成に使用する IBM Language Environment プリリンク・エディター・ユーティリティーの呼び出しロード・モジュールを入れるデータ・セットを指定します。


CPPCLLIB dsname C++ コンパイラーが使用する、C リンケージ・エディター自動呼び出しライブラリー用のデータ・セットを指定します。


CPPCSLIB dsname C++ コンパイラーが使用する、C コンパイラー・ヘッダーを入れるデータ・セットを指定します。

デフォルトは ‘‘‘CEE.SCEEH.H’’’ です。

CPPLLIB dsname C++ プリリンク自動呼び出しライブラリーを含むデータ・セットを指定します。

デフォルトは ‘‘‘CEE.SCEECPP’’’ です。

DSNH (TSO CLIST)




CPPPMSGS dsname C++ プログラムを作成するときに IBM プリリンク・エディターが使用するメッセージ・ライブラリーを入れるデータ・セットを指定します。



CPPSLIB dsname クラス・ライブラリー用の C++ ヘッダー・ファイルを含むデータ・セットを指定します。

デフォルトは ‘‘‘CBC.SCLBH.HPP’’’ です。

CPPUTIL dsname C++ コンパイラーをセットアップし、実行するプロシージャーを含むデータ・セットを指定します。

デフォルトは ‘‘‘CBC.SCCNUTL’’’ です。

DATE ISO

JIS

EUR

LOCAL

戻される日付値の形式を指定します。この形式は、ロケーションのデフォルトとして指定された形式をオーバーライドします。

デフォルトは DB2 のインストール時に指定される値で、データ専用ロード・モジュールの DSNHDECP に書き込まれます。

DBRMLIB DEFAULT

dsname(member)

NONE

DB2 プリコンパイル・ステップ中に使用される DBRM ライブラリーとメンバー名を入れる、区分データ・セットとオプションのメンバー名を指定します。個々のフェーズにおいて DBRM メンバーおよびライブラリー名を個別に指定できるため、DBRMLIB パラメーターおよび関連のある接頭部を用いて特定のフェーズを識別しなければなりません。

DBRMLIB は、DB2 プリコンパイラーの処理中に DBRMLIB DD ステートメントに定義される、DBRM ライブラリーおよびメンバーを指定します。

DEFAULT は、DB2 プリコンパイラー処理に定義された同じ DBRM ライブラリー・データ・セット (DBRMLIB(parameter)) が、LIBRARY(dsname) サブコマンド・キーワードでも使用されることを示します。プリコンパイラーDBRMLIB を指定しなかった場合は、INPUT データ・セット名に基づくデフォルト生成の DBRMLIB ライブラリーが使用されます。

dsname は DSNH OUTNAME パラメーター値、またはそのデフォルトTEMP を使用して生成され、定数 DBRM がその接頭部に付加されます。例えば、outname.DBRM や TEMP.DBRM のようになります。

member は、DSNH INPUT パラメーターに指定されたデータ・セット・メンバー名、または以下のようなデータ・セット名から得られます。

INPUT(outname.DBRM(dbrmmem)) と仮定した場合– outname.DBRM(dbrmmem) - メンバー名が指定される場合– outname.DBRM(dbrm) - メンバー名が指定されない場合

NONE は、LIBRARY(dsname) サブコマンド・キーワードが呼び出し時に指定されないことを示します。

DSNH (TSO CLIST)




DECARTH DEFAULT

15

31

10 進数の最高精度を指定します。

DEFAULT が指定する値は、インストール時に APPLICATION

PROGRAMMING DEFAULTS パネルの DECIMAL ARITHMETIC フィールドで選ばれた値です。

値 15 は、精度 15 以下の 10 進数値に関する 10 進算術演算が、精度および結果の位取りを判別する既存の規則に従って行われることを指定します。

値 31 は、精度が 15 ～ 31 の 10 進数値に関する 10 進算術演算が、精度および結果の位取りを判別する新しい規則に従って行われることを指定します。

DECARTH は、Fortran では無視されます。

DECIMAL COMMA

PERIOD

10 進および浮動小数点リテラルの、小数点標識を指定します。DECIMAL

が有効なのは、COBOL プログラムの場合のみです。他のすべてのプログラムでは PERIOD が強制的に使用されます。

COMMA を指定すると、標識がコンマになります。

PERIOD を指定すると、標識がピリオドになります。

デフォルトは、インストール時に DB2 APPLICATION PROGRAMMING

DEFAULTS パネルで設定された DECIMAL POINT フィールドの値です。

DELIMIT DEFAULT

APOST

QUOTE

APOST または QUOTE プリコンパイラー・オプションを指定してホスト言語ステートメント内で使用されるストリング区切り文字を示します。DELIMIT が有効なのは、COBOL プログラムの場合のみです。他のすべてのプログラムでは APOST が強制的に使用されます。

DEFAULT が指定する値は、インストール時に APPLICATION

PROGRAMMING DEFAULTS パネルの STRING DELIMITER フィールドで選ばれた値です。

APOST は、ホスト言語ステートメントのストリング区切り文字としてアポストロフィを指定します。

QUOTE は、ホスト言語ステートメントのストリング区切り文字として引用符を指定します。

ENTRY entry-name リンケージ・エディターによって割り当てられた入り口点を指定します。

デフォルトは、ホスト言語および RUN の値によって異なります。v PL/I 言語の場合、ENTRY 値のデフォルトは以下のとおりです。

– RUN 値が CICS の場合、NONE

– その他の RUN 値の場合、PLISTART

v アセンブラー言語の場合、RUN 値が IMS であれば ENTRY 値のデフォルトは DLITASM です。

v COBOL の場合、RUN 値が IMS であれば ENTRY 値のデフォルトはDLITCBL です。

v その他の言語の場合、RUN 値がどれであっても ENTRY 値のデフォルトは NONE (指定の入り口点なし) です。

DSNH (TSO CLIST)




FLAG I

C

E

W

表示したメッセージを指定します。対応するタイプのメッセージを表示するには、下記のいずれかの値を使用してください。I すべての、通知メッセージ、警告メッセージ、エラー・メッセー

ジ、および完了メッセージW 警告、エラー、完了の各メッセージのみ。E エラーと完了のメッセージのみ。C 完了メッセージのみ

FORTLIB dsname FORTRAN ルーチンに使用されるリンケージ・エディター組み込みライブラリーを指定します。

デフォルトは ‘‘‘SYS1.VSF2FORT’’’ です。

FORTLOAD dsname VS FORTRAN コンパイラーのロード・モジュールを入れるデータ・セットを指定します。


デフォルトは ‘‘‘SYS1.VSF2VCOMP(FORTVS2)’’’ です。

GRAPHIC NONE

NO

YES

プリコンパイラーの DSNHDECP MIXED オプションの値を指定します。

NONE は、インストール中に指定されたデフォルトが使用されることを示します。

NO は、データが混合 DBCS ではないことを示します。

YES は、すべての文字データが混合 DBCS になれることを示します。

GRAPHIC は、C では無視されます。

HOST ASM

C

CPP

IBMCOB

FORTRAN

PLI

SQL ステートメントの組み込みが行われるホスト言語を定義します。

COBOL と COB2 も許容値ですが、使用されなくなりました。

ユーザーのプログラムが以下のいずれかのタイプの場合、DB2I を使用してそのプログラムを作成することはできません。

v オブジェクト指向拡張機能を使用する COBOL プログラム

v オブジェクト指向拡張機能を使用し、複数のコンパイル単位で構成されるC++ プログラム

デフォルトは、インストール時に DB2 APPLICATION PROGRAMMING

DEFAULTS パネルで設定された LANGUAGE DEFAULT フィールドの値です。

IMSPRE prefix IMS 用のリンケージ・エディターによって組み込まれるルーチンに使用される RESLIB の接頭部を指定します。

デフォルトは IMSVS です。

INPUT dsname ホスト言語のソース・ステートメントおよび SQL ステートメントを入れるデータ・セットを指定します。


LINECOUNT integer 印刷出力の各ページで印刷される、見出しを含めた行数を示します。

デフォルトは 60 です。

DSNH (TSO CLIST)




LINK YES

NO

コンパイルまたはアセンブリーが正常に完了した後でリンケージ・エディターを実行するかどうかを指定します。

YES は、リンケージ・エディターを実行することを示します。プリコンパイラーからの DSNHLI 入り口点は、RUN パラメーターによって指定された該当する言語インターフェース・モジュールに出力されます。

NO は、リンケージ・エディターの処理を回避することを示します。

LLIB

Ln LIB

NONE

dsname

リンケージ・エディターによって組み込まれるオブジェクトまたはロード・モジュールを入れるデータ・セットを指定します。パラメーター LnLIB (n

には 2、3、4 のいずれかを指定できます) は LLIB の拡張で、データ・セット名のリストの渡し方を単純化するために使用されます。

LLIB および Ln LIB ライブラリーは、特定ホスト言語の XLIB ライブラリーおよびリンケージ・エディター組み込みライブラリーに連結されます。この連結においては、オブジェクトやロード・モジュール・ライブラリーを混合させないでください。

指定するデータ・セットがない場合は、デフォルトの NONE を使用します。

LOAD dsname リンケージ・エディター (ロード・モジュール) からの出力が含まれるデータ・セットを指定します。


デフォルトは RUNLIB.LOAD です。

LOPTION NONE

string

リンケージ・エディター・オプションのリストを指定します。使用できるオプションについては、該当する z/OS 資料を参照してください。

指定するオプションがない場合は、デフォルトの NONE を使用します。

MACRO YES

NO

PL/I プログラムをプリコンパイルする前にマクロ・プリプロセッサーを実行するかどうかを指定します。PL/I マクロ処理プログラムを使用する場合は、PL/I *PROCESS ステートメントを用いてオプションを PL/I コンパイラーに渡してはなりません。必要なオプションを PL/I コンパイラーに渡すときには、DSNH コマンドの COPTION パラメーターを使用できます。

NEWFUN NO

YES

DB2 バージョン 8 で取り入れられた機能について構文を許可するかどうかを指定します。詳細については、「DB2 アプリケーション・プログラミングおよび SQL ガイド」のプリコンパイラー・オプションの説明を参照してください。

DSNH (TSO CLIST)


|||||



NOFOR NO

YES

静的 SQL ステートメント内のすべての FOR UPDATE OF 文節がオプションであるかどうかを指定します。

NOFOR(YES) を指定する場合、FOR UPDATE OF 文節はオプションです。ユーザーに更新権限がある列に対しては、位置付け更新を行うことができます。

NOFOR(NO) を指定して、カーソルを位置付け更新に使用する場合、DECLARE CURSOR ステートメントに現れるすべての照会に FOR

UPDATE OF 文節が入っていなければなりません。文節には、カーソルが更新できる列がすべて指定されている必要があります。

STDSQL(YES) オプションが有効であれば、このオプションは暗黙指定されます。

OPTIONS NO

YES

プリコンパイラーまたは CICS コマンド変換プログラムの実行時に使用したオプションを、出力リストと共に印刷するかどうかを指定します。

OUTNAME TEMP

string

中間データ・セット名を形成するときに使用する接頭部を指定します。

string はアポストロフィで囲んだり、最初の文字を INPUT の dsname と同じにしてはなりません。また、特殊文字を含めることもできません。

PARMS NONE

string

コンパイルされたプログラムの実行時にそのプログラムに渡すパラメーター・ストリングを指定します。このパラメーターは、要求されたランタイム実行環境が TSO である場合にのみ有効です。CAF がランタイム実行環境として指定されている場合は、このパラメーターは無視されます。

指定するパラメーター・ストリングがない場合は、デフォルトの NONE を使用します。

PASS ONE または 1

TWO または 2

プリコンパイラーが使用するパスの数を指定します。パスが 1 つあると処理時間が節約されますが、この変数を参照するには事前にプログラムでホスト変数を宣言する必要があります。PASS は COBOL または Fortran においては有効ではないため、ONE が強制的に指定されます。

PL/I および C の場合のデフォルトは、ONE または 1 です。

アセンブラーの場合のデフォルトは、TWO または 2 です。

PCLOAD dsname プリコンパイラー・ロード・モジュールを指定します。


The default is ‘*(DSNHPC)’.

PLAN plan-name バインド処理によって作成されるアプリケーション・プランを指定します。

デフォルトのプラン名は、INPUT データ・セットで定義された以下の使用可能な選択項目の 1 番目です。v DBRM メンバー名v 左端の修飾子

plan-name は DEFAULT であってはなりません。

名前が見つからないと、プランは作成されません。

DSNH (TSO CLIST)




PLIB

Pn LIB

NONE

dsname

プリコンパイル中に SQL INCLUDE ステートメントによって組み込まれたホスト言語のソース・ステートメントまたは SQL ステートメントを入れる、データ・セットを指定します。パラメーター PnLIB (n には 2、3、4

のいずれかを指定できます) は PLIB の拡張で、データ・セット名のリストの渡し方を単純化するために使用されます。

指定するデータ・セットがない場合は、 NONE を使用します。

PLI2LIB dsname PL/I ルーチンに使用されるリンケージ・エディターの共通ライブラリーを指定します。


PLILIB dsname PL/I ルーチンに使用されるリンケージ・エディター基本ライブラリーを指定します。


PLILOAD dsname PL/I コンパイラーのロード・モジュールを入れるデータ・セットを指定します。


デフォルトは ‘‘‘IBM.SIBMZCMP(IBMZPLI)’’’ です。

PLIPLNK dsname PL/I プログラムの作成に使用する IBM Environment プリリンク・エディター・ユーティリティーの呼び出しロード・モジュールを入れるデータ・セットを指定します。



PLIPMSG dsname PL/I プログラムを作成するために IBM プリリンク・エディターが使用するメッセージ・ライブラリーを入れるデータ・セットを指定します。



POPTION NONE

string

C コンパイラー言語のプリリンク・ユーティリティー・オプションのリストを指定します。用意されているオプションについて詳しくは、「z/OS C/C++

ユーザーズ・ガイド」を参照してください。

指定するオプションがない場合は、デフォルトの NONE を使用します。

PRECOMP YES

NO

プリコンパイルするかどうかを指定します。

DSNH (TSO CLIST)




PRELINK YES

NO

C コンパイラーのプリリンク・ユーティリティーを実行して、プログラムを再入可能にするかどうかを指定します。このユーティリティーは、1 つ以上のテキスト・デックのコンパイル時の初期設定情報 (静的で書き込み可能な場合) を単一の初期設定の単位に連結します。このステップを要求する場合は、コンパイル・ステップの後で、かつリンク・エディット・ステップの前でなければなりません。

このパラメーターは、プリリンク・ステップも含まれている IBMCOB に適用することができます。プリリンク・ステップを C または IBMCOB に適用できるかどうかは、HOST パラメーターに値 C、CPP、または IBMCOB

を選択するかどうかにより決まります。

C および IBMCOB に関するプリリンク処理の説明は、該当する言語資料に記載されています。

プリリンク・ユーティリティーをサポートしないホスト言語コンパイラーに対して PRELINK(YES) が指定されるかまたはデフォルトにされた場合、DB2 は警告メッセージ DSNH760I を出し、プリリンク・ユーティリティーの処理はう回されます。

PRINT NONE

dsname

LEAVE

TERM

オプション、ソース・ステートメント、相互参照、エラー、要約情報のリストを含む印刷出力の送り先を指定します。

デフォルトの NONE を指定すると、印刷出力が省略されます。

dsname は、出力に使用されるデータ・セットを指定します。dsname は、アポストロフィで囲んではなりません。dsname の前に、現行のユーザー・プロファイルが付けられます。次の接尾部も加えられます。v SYSCPRT.LIST、PL/I マクロ・リストの場合 (このリストはコンパイラー・リストによって重ね書きされます)

v PCLIST、プリコンパイラー・リストの場合v CXLIST、CICS コマンド変換プログラムのリストの場合v LIST、コンパイラー・リストの場合

HOST(CPP) を指定するときは、コンパイル・ステップに関する PRINT

パラメーターは無視されます。v SYSOUT.PRELLIST、C プリリンク・ユーティリティー・リストの場合v LINKLIST、リンク・エディット・リストの場合

LEAVE は、出力を指定の印刷データ・セットへ送ります。印刷データ・セットは、次のいずれかの方法で割り振ることができます。v 動的にv DSNH CLIST を実行するときに使用する JCL で (バッチ・モードの場合)

v TSO ALLOCATE コマンドによって (DSNH の実行前)

TERM は、出力を端末へ送ります。

PSECSPAC integer SPACEUN によって指定された装置で印刷データ・セットに割り振る 2 次スペースの大きさを指定します。


DSNH (TSO CLIST)




PSPACE integer SPACEUN によって指定された装置の印刷データ・セットの 1 次サイズを指定します。


RCTERM integer 以降のステップの実行を防止するプリコンパイル・ステップからの戻りコードの最小値を指定します。


RUN TSO またはYES

BATCH またはNO

CAF

CICS

IMS

RRSAF

直前のステップが正常に終了した場合にコンパイル済みプログラムを実行するかどうかを指定し、また、呼び出す場合は実行する環境を指定します。RUN パラメーターの選択により LLIB の選択が影響を受けることがあります。

TSO または YES は、アプリケーション・プログラムを TSO 環境で実行するためにスケジュールすることを指定し、コンパイルされたプログラムを実行します。

BATCH または NO はアプリケーション・プログラムの実行スケジュールを行わないことを示し、実行環境としてデフォルト TSO を採用します。

CAF は、アプリケーション・プログラムが呼び出し接続機能環境での実行をスケジューリングされていることを示します。アプリケーション・プログラムの実行スケジュールを行わずに実行環境として CAF を指定する場合は、BATCH または NO を CAF と共に指定してください。(BATCH,CAF) または (NO,CAF)

CICS は、アプリケーション・プログラムが実行をスケジューリングされていなくて、かつ CICS を run-time 時実行環境として識別することを示します。CICS アプリケーションは TSO では実行できません。

IMS は、アプリケーション・プログラムが実行をスケジューリングされていなくて、かつ IMS を実行時実行環境として識別することを示します。IMS

アプリケーションは TSO では実行できません。

RRSAF は、アプリケーション・プログラムが実行をスケジューリングされていなくて、かつ RRSAF を実行時実行環境として識別することを示します。RRSAF アプリケーションは TSO では実行できません。

RUNIN TERM

dsname

LEAVE

NONE

RUN ステップ用入力の入手先を指定します。

デフォルトの TERM は、入力を端末から入手します。

dsname は、入力に使用されるデータ・セットを指定します。

とられる唯一のステップが LINK と RUN の場合は、LEAVE は SYSIN から入力を入手します。言語が FORTRAN の場合は、LEAVE は FT05F001

から入力データを入手します。他のいずれの場合にも LEAVE を使用ないでください。

NONE は、入力ファイルの割り振りを行いません。

DSNH (TSO CLIST)




RUNOUT TERM

dsname

LEAVE

NONE

RUN ステップから出力をどこに送るかを指定します。

デフォルトの TERM は、出力を端末に送信します。

dsname は、出力を受け取るデータ・セットを指定します。

とられる唯一のステップが LINK と RUN の場合は、LEAVE はSYSPRINT へ出力を送信します。言語が FORTRAN の場合は、LEAVE はFT06F001 へ出力を送信します。他のいずれの場合にも LEAVE を使用ないでください。

NONE は、RUN ステップ用に出力ファイルを割り振りません。

SOMDLLI dsname SOM/MVS DLL インポート・ライブラリーの名前を指定します。


SOURCE NO

YES

プリコンパイラー、CICS コマンド変換プログラム、およびコンパイラーからの出力とともにソース・コードと診断を印刷するかどうかを指定します。

SPACEUN TRACK

CYLINDER

PSPACE および WSPACE のスペースの単位を指定します。

TRACK は、スペースの単位を 1 トラックとします。

CYLINDER は、スペースの単位を 1 シリンダーとします。

SQL DB2

ALL

SQL ステートメントの解釈方法を指定し、DB2 UDB for z/OS またはその他のデータベース管理システムのいずれかが使用する構文を検査します。

デフォルトの DB2 は、DB2 UDB for z/OS によって使用されるように SQL

ステートメントを解釈し、構文を検査することを示します。SQL(DB2) は、サーバーが DB2 サブシステムである場合に勧められる DRDA アクセス用のモードです。

ALL は、SQL ステートメントが、DB2 UDB for z/OS ではないデータベース管理システムによって使用されるように解釈されることを示します。SQL

構文検査はバインド時まで据え置かれるため、リモート・ロケーションは結果の DBRM をバインドすることができます。SQL(ALL) が有効なときにSAA 予約語が ID として使用される場合、プリコンパイラーは通知メッセージを出します。SQL(ALL) は、アプリケーションの作成を非 DB2 UDB

for z/OS 環境で実行されるように行っている場合には勧められるモードです。

デフォルトは SQL(DB2) です。

DSNH (TSO CLIST)




SQLDELIM DEFAULT

APOSTSQL

QUOTESQL

SQL ストリング区切り文字、および暗黙に SQL ステートメントの SQL エスケープ文字を設定するときは、APOSTSQL または QUOTESQL プリコンパイラー・オプションを指定します。ストリング区切り文字としてどちらの文字を選んでも、もう一方の文字が SQL エスケープ文字に使用されます。

このパラメーターが有効なのは、COBOL の場合のみです。PL/I、Fortran、およびアセンブラー言語のプログラムの場合、プリコンパイラーではAPOSTSQL オプションが強制的に使用されます。

DEFAULT が指定する値は、インストール時に「APPLICATION

PROGRAMMING DEFAULTS」パネルの「SQL STRING DELIMITER」フィールドで選ばれた値です。

APOSTSQL は、ストリング区切り文字がアポストロフィ (') でエスケープ文字が引用符 (") であることを指定します。

QUOTESQL は、ストリング区切り文字が引用符 (") でエスケープ文字がアポストロフィ (') であることを指定します。

SQLFLAG IBM またはSAA

STD または 86

ssname

qualifier

このオプションはサポートされなくなりました。

STDSQL NO

YES または 86

ANSI 規則のサブセットを使用して SQL を解釈するかどうかを指定します。

NO は、DB2 規則が使用されることを指定します。

YES または 86 は自動的に、NOFOR オプションが使用されることを暗黙指定します。

SUFFIX YES

NO

TSO 標準命名規則に従う必要があるかどうかを指定します。この規則では、入力データ・セットの名前に TSO 許可 ID 接頭部とホスト言語接尾部が加えられます (その名前がアポストロフィで囲まれていないか、しかるべき接尾部ですでに終了していない場合に限られます)。例えば、userid.name.COBOL、userid.name.PLI、userid.name.Fortran、またはuserid.name.ASM といった名前になります。

SYSTEM subsystem-name DB2 サブシステム名を、z/OS オペレーティング・システムに認識されているとおりに指定します。

デフォルトは、インストール定義サブシステム名 (DSN の場合が多い) です。

DSNH (TSO CLIST)




TERM TERM

dsname

LEAVE

NONE

エラー情報、エラー・ステートメント、および要約情報を含む端末出力を、どこへ送るかを指定します。

デフォルトの TERM は、出力を端末に送信します。

dsname は、端末出力に使用されるデータ・セットを指定します。dsname

は、アポストロフィで囲んではなりません。dsname には、次の接尾部が加えられます。v PCTERM、プリコンパイラー出力の場合v LIST、コンパイラー出力の場合

LEAVE は、出力を SYSTERM の現行割り振り先へ送ります。

NONE は、端末出力を省略します。

TIME ISO

JIS

EUR

LOCAL

戻される時間値の形式を指定して、ロケーションのデフォルトとして指定された形式を一時変更します。

このオプションが以前に指定したデフォルトをオーバーライドするため、デフォルトはありません。

VERSION version-id

AUTO

DB2 プリコンパイル・ステップ時に、プログラムおよび関連した DBRM に対するバージョン ID の名前を指定します。

AUTO は、バージョン ID を生成するにあたって整合性トークンが使用されることを指定します。整合性トークンがタイム・スタンプの場合、そのタイム・スタンプは ISO 文字形式に変換され、バージョン ID として使用されます。

プリコンパイラーの呼び出し時に指定された場合のデフォルトは、バージョン ID なしです。

WORKUNIT unit 印刷および作業データ・セット用に使用する装置を指定します。

unit は、装置名でも装置タイプでも構いません。

バッチ・モードでのデフォルトは、任意の適格装置です。

その他のモードでのデフォルトは、現行 TSO ユーザーの UADS 装置名です。

WSECSPAC integer SPACEUN によって指定された装置の中で作業データ・セットに割り振る 2

次スペースの量を指定します。


WSPACE integer SPACEUN によって指定された装置の作業データ・セットの 1 次サイズを指定します。


XLIB dsname DB2 ルーチンに使用されるリンケージ・エディター組み込みライブラリーを指定します。

デフォルトは ‘‘‘prefix.SDSNLOAD’’’ です。

XREF NO

YES

ソース・ステートメントで使用される記号名のソート済み相互参照リストをプリコンパイラーからの出力と一緒に印刷するかどうかを指定します。

DSNH (TSO CLIST)




注: プリコンパイラー・オプションは、ODBC の振る舞いには影響を与えません。

DSNH/DSN サブコマンドの要約表 23 および 282ページの表 24 には、BIND PLAN と BIND PACKAGE をサポートする機能の相違点が示されています。それぞれの表で、DSNH CLIST パラメーターとその対応する DSN BIND PLAN または BIND PACKAGE サブコマンド・キーワード (もしあれば) が関連付けられます。全般的には以下の点が当てはまります。

v CLIST パラメーターの機能と値は、別途注記がない限りその対応する DSN サブコマンド・キーワードの場合と同じです。

v DSNH パラメーター値が NONE であれば、対応する DSN キーワードがサブコマンド呼び出しで指定されないことを示します。例外は該当箇所に注記されます。

DSNH CLIST/BIND PLAN サブコマンドの比較表 23. DSNH CLIST/ BIND PLAN サブコマンドの要約

DSNH CLIST BIND PLAN サブコマンド

コメントパラメーター値キーワード値

ACQUIRE USE

ALLOCATE

ACQUIRE USE

ALLOCATE

ACTION REPLACE

ADD

ACTION REPLACE

ADD

BDMEM DEFAULT1

dbrm-member-name

NONE2

MEMBER dbrm-member-name 1 次のソースの 1 つから得られる DBRM メンバー名 (リスト順)。v BDBRMLIB メンバー名v DBRMLIB メンバー名v INPUT メンバー名、または

dsname を用いて生成されるメンバー名

2 キーワードはサブコマンド呼び出しでは指定されません。

BIND YES1

NO2

(command-verb) 1BIND PLAN サブコマンドを実行します。

2BIND PLAN サブコマンドは実行しません。

BLIB NONE1

dsname

LIBRARY dbrm-pds-name 1 キーワードはサブコマンド呼び出しでは指定されません。

DSNH (TSO CLIST)


表 23. DSNH CLIST/ BIND PLAN サブコマンドの要約 (続き)



Bn LIB1 NONE2

dsname

LIBRARY dbrm-pds-name のリスト

1n は、2、3、4、5、6、7、または 8 のいずれかにすることができます。BLIB パラメーターを使用して最初のデータ・セット名を指定します。追加のデータ・セット名があれば、このパラメーターを使用してそれを指定します。

2 追加のデータ・セット名はありません。

BMEM 1 NONE2

dbrm-member

-names のリスト

MEMBER dbrm-member-name

のリスト

1 BDMEM パラメーターを使用して最初の DBRM メンバー名を指定し、このパラメーターを使用して追加メンバー名を個別に指定します。

2 追加の DBRM メンバー名はありません。

CACHESIZE NONE1

decimal-value 2

CACHESIZE decimal-value 2 1 サイズはサブシステムにより指定されます。

2 サイズを 0 ～ 4096 バイトで指定します。

CICS NONE1

application-id

CICS application-id 1 キーワードはサブコマンド呼び出しでは指定されません。

CURRENTDATA YES

NO

NONE

CURRENTDATA YES

NO

CURRENTSERVER NONE1

location-name

CURRENTSERVER location-name

DBPROTOCOL NONE

DRDA

PRIVATE

DBPROTOCOL DRDA

PRIVATE

PRIVATE を指定した場合は、バージョン 7 の後で DB2 に追加された SQL ステートメントをアプリケーションに組み込むことはできません。

DSNH (TSO CLIST)





BDBRMLIB DEFAULT1

dsname(member)

NONE2

LIBRARY dbrm-pds-name 1 プリコンパイラーDBRMLIB データ・セットが使用されます。プリコンパイラー DBRMLIB を指定しなかった場合は、INPUT データ・セット名に基づくデフォルト生成の DBRMLIB ライブラリーが使用されます。


DEFER NONE1

PREPARE

DEFER PREPARE 1 キーワードはサブコマンド呼び出しでは指定されません。

DEGREE 1

ANY

DEGREE 1

ANY

DISABLE NONE

BATCH

CICS

DB2CALL

IMS

DLIBATCH

IMSBMP

IMSMPP

RRSAF

DISABLE NONE

BATCH

CICS

DB2CALL

IMS

DLIBATCH

IMSBMP

IMSMPP

RRSAF

DISCONNECT EXPLICIT

AUTOMATIC

CONDITIONAL

DISCONNECT EXPLICIT

AUTOMATIC

CONDITIONAL

DLIBATCH NONE1

connection-id

DLIBATCH connection-name 1 キーワードはサブコマンド呼び出しでは指定されません。

DYNAMICRULES RUN

BIND

DYNAMICRULES RUN

BIND

ENABLE NONE

*

BATCH

CICS

DB2CALL

IMS

DLIBATCH

IMSBMP

IMSMPP

RRSAF

ENABLE NONE

*

BATCH

CICS

DB2CALL

IMS

DLIBATCH

IMSBMP

IMSMPP

RRSAF

EXPLAIN NO

YES

EXPLAIN NO

YES

DSNH (TSO CLIST)





FLAG I

C

E

W

FLAG I

C

E

W

IMSBMP NONE1

imsid

IMSBMP imsid 1 キーワードはサブコマンド呼び出しでは指定されません。

IMSMPP NONE1

imsid

IMSMPP imsid 1 キーワードはサブコマンド呼び出しでは指定されません。

ISOLATION RR

RS

CS

UR

ISOLATION RR

RS

CS

UR

KEEPDYNAMIC NO

YES

KEEPDYNAMIC NO

YES

NODEFER NONE1

PREPARE

NODEFER PREPARE 1 キーワードはサブコマンド呼び出しでは指定されません。

OPTHINT (’ ’)

(’hint-id’)

OPTHINT (’ ’)

(’hint-id’)

OWNER NONE1

authorization-id

OWNER authorization-id 1 キーワードはサブコマンド呼び出しでは指定されません。

PATH (schema-name)

(USER)

(schema-name,

USER...)

PATH (schema-name)

(USER)

(schema-name,

USER...)

PKLIST NONE1

collection-id

および package-

names

PKLIST collection-id およびpackage-name のリスト

1 パッケージ名はサブコマンド呼び出しでは指定されません。

PLAN plan-name 1 PLAN

(primary-keyword)

plan-name 1plan-name には DEFAULT を指定することはできません。デフォルトの plan-name は、INPUT データ・セットで定義された以下の使用可能な選択項目の 1 番目です。v DBRM メンバー名v 左端の修飾子

名前が見つからないと、プランは作成されません。

QUALIFIER NONE1

implicit-qualifier

QUALIFIER qualifier-name 1 キーワードはサブコマンド呼び出しでは指定されません。

DSNH (TSO CLIST)





RELEASE COMMIT

DEALLOCATE

RELEASE COMMIT

DEALLOCATE

REOPT NONE1

VARS

REOPT NONE

ALWAYS

ONCE


RETAIN NO1

YES2

RETAIN 1 キーワードはサブコマンド呼び出しでは指定されません。

2 キーワードはサブコマンド呼び出しで指定されます。

SQLRULES DB2

STD

SQLRULES DB2

STD

VALIDATE RUN

BIND

VALIDATE RUN

BIND

DSNH CLIST/BIND PACKAGE サブコマンドの比較表 24. DSNH CLIST/ BIND PACKAGE サブコマンドの要約

DSNH CLIST BIND PACKAGE サブコマンド


PACTION REPLACE

ADD

ACTION REPLACE

ADD

PBIND NO1

YES2

(command-verb) 1BIND PACKAGE サブコマンドを実行しません。

2BIND PACKAGE サブコマンドを実行します。

PCICS NONE1

application-id

CICS application-id 1 キーワードはサブコマンド呼び出しでは指定されません。

COPY NONE1

collection-id.

package-id

COPY collection-id.

package-id


COPYVER version-id COPYVER version-id

PCURRENTDATA NO

YES

NONE

CURRENTDATA YES

NO

PDBPROTOCO NONE

DRDA

PRIVATE

DBPROTOCOL DRDA

PRIVATE

PRIVATE を指定した場合は、バージョン 7 の後で DB2 に追加された SQL ステートメントをアプリケーションに組み込むことはできません。

DSNH (TSO CLIST)


表 24. DSNH CLIST/ BIND PACKAGE サブコマンドの要約 (続き)



PDBRMLIB DEFAULT1

dsname(member)

NONE2

LIBRARY dbrm-pds-name 1 プリコンパイラーDBRMLIB データ・セットが使用されます。プリコンパイラー DBRMLIB を指定しなかった場合は、INPUT データ・セット名に基づくデフォルト生成の DBRMLIB ライブラリーが使用されます。


PDEFER NONE1

PREPARE

DEFER PREPARE 1 キーワードはサブコマンド呼び出しでは指定されません。

PDEGREE 1

ANY

DEGREE 1

ANY

PDISABLE NONE

BATCH

CICS

DB2CALL

IMS

DLIBATCH

IMSBMP

IMSMPP

REMOTE

RRSAF

DISABLE NONE

BATCH

CICS

DB2CALL

IMS

DLIBATCH

IMSBMP

IMSMPP

REMOTE

RRSAF

PDLIBATCH NONE1

connection-id

DLIBATCH connection-name 1 キーワードはサブコマンド呼び出しでは指定されません。

PDMEM DEFAULT1

dbrm-member-

name

NONE2

MEMBER dbrm-member-name 1 次のソースの 1 つから得られる DBRM メンバー名 (リスト順)。v PDBRMLIB メンバー名v DBRMLIB メンバー名v INPUT メンバー名、または

dsname を用いて生成されるメンバー名


PDYNAMICRULES NONE

RUN

BIND

DEFINE

INVOKE

DYNAMICRULES RUN

BIND

DEFINE

INVOKE

DSNH (TSO CLIST)





PENABLE NONE

*

BATCH

CICS

DB2CALL

IMS

DLIBATCH

IMSBMP

IMSMPP

REMOTE

RRSAF

ENABLE NONE

*

BATCH

CICS

DB2CALL

IMS

DLIBATCH

IMSBMP

IMSMPP

REMOTE

RRSAF

EXPLAIN NO

YES

EXPLAIN NO

YES

PFLAG I

C

E

W

FLAG I

C

E

W

PIMSBMP NONE1

imsid

IMSBMP imsid 1 キーワードはサブコマンド呼び出しでは指定されません。

PIMSMPP NONE1

imsid

IMSMPP imsid 1 キーワードはサブコマンド呼び出しでは指定されません。

PISOLATION NONE1

RR

RS

CS

UR

NC

ISOLATION1 RR

RS

CS

UR

NC

1 ローカル・パッケージの場合、デフォルトは、実行時に追加されるプランのデフォルトと同じになります。リモート・パッケージの場合、デフォルトは RR です。

PKEEPDYNAMIC NONE

NO

YES

KEEPDYNAMIC NO

YES

PNODEFER NONE1

PREPARE

NODEFER PREPARE 1 キーワードはサブコマンド呼び出しでは指定されません。

POPTHINT (’ ’)

(’hint-id’)

OPTHINT (’ ’)

(’hint-id’)

POWNER NONE1

authorization-id

OWNER authorization-id 1 キーワードはサブコマンド呼び出しでは指定されません。

PACKAGE DEFAULT1

location-name.

collection-id

PACKAGE location-name.

collection-id

1INPUT パラメーター・データ・セットに定義されたメンバー名、またはメンバー名が指定されていない場合はデータ・セット名。

DSNH (TSO CLIST)





PPATH (schema-name)

(USER)

(schema-name,

USER, ...)

PATH (schema-name)

(USER)

(schema-name,

USER, ...)

PQUALIFIER NONE1

implicit-qualifier

QUALIFIER qualifier-name 1 キーワードはサブコマンド呼び出しでは指定されません。

PRELEASE NONE1

COMMIT

DEALLOCATE

RELEASE1 COMMIT

DEALLOCATE

1 ローカル・パッケージの場合、デフォルトは、実行時に追加されるプランのデフォルトと同じになります。リモート・パッケージの場合、デフォルトは NONE です。

REOPT NONE1

VARS

REOPT NONE

ALWAYS

ONCE


REMOTE NONE1

location-name,

<luname>

REMOTE ネットワーク名 1 キーワードはサブコマンド呼び出しでは指定されません。

REPLVER NONE1

version-id

REPLVER version-id 1version-id はサブコマンド呼び出しでは指定されません。

SQLERROR NOPACKAGE

CONTINUE

SQLERROR NOPACKAGE

CONTINUE

PVALIDATE RUN

BIND

VALIDATE RUN

BIND

使用上の注意CICS 変換プログラム: CICS 変換プログラム・オプションは、アセンブラー・プログラムのソース言語では使用しないでください。このオプションを CICSOPT オプションを使用して変換プログラムに渡してください。

COBOL オプション: COBOL DYNAM オプションには、次のようないくつかの制限があります。

v このオプションは CICS では使用できません。

v VS COBOL II ライブラリーまたは言語処理環境 (z/OS 言語環境プログラム) ライブラリーを使用する必要があります。

v このオプションを TSO またはバッチで使用するには、ステップ・ライブラリー、ジョブ・ライブラリー、またはリンク・リスト連結において、IMS RESLIB

の前に SDSNLOAD ライブラリーがなければなりません。

v このオプションを IMS で使用する場合は、DSNLOAD の前に IMS RESLIB を指定しなければなりません。

DSNH (TSO CLIST)


表 25 に示されているように、COBOL オプションによっては DSNH CLIST で提供されていない DD ステートメントを必要とするものがあります。

表 25. 追加の DD ステートメントが必要な COBOL オプション

オプション必要とされるステートメント

CDECK SYSPUNCH

COUNT SYSCOUNT、SYSDBG、SYSDBOUT、SYSUT5、デバッグ・ファイル

DECK SYSPUNCH

DUMP SYSABEND、SYSDUMP、または SYSUDUMP

FDECK SYSPUNCH

FLOW SYSCOUNT、SYSDBG、SYSDBOUT、SYSUT5、デバッグ・ファイル

LVL SYSUT6

STATE SYSCOUNT、SYSDBG、SYSDBOUT、SYSUT5、デバッグ・ファイル

SYMDUMP SYSCOUNT、SYSDBG、SYSDBOUT、SYSUT5、デバッグ・ファイル

SYST SYSOUT

SYSx SYSOUx

TEST SYSUT5

COBOL パラメーター: COBOL コンパイラーに渡される BUF および SIZE パラメーターは、変更しなければならない場合があります。

COPTION: LINECOUNT、SOURCE、TERM、および XREF コンパイラー・オプションの値を指定する場合には、COPTION パラメーターは使用しないでください。その代わりに、DSNH LINECOUNT、SOURCE、TERM、および XREF キーワードを使用してください。

Fortran および PL/I に関する考慮事項: 可変長フォーマットの入力レコードはサポートされません。

ライブラリーの制限: 最大 8 つのバインド・ライブラリー、4 つのプリコンパイル・ライブラリー、4 つのコンパイル・ライブラリー、および 4 つのリンク・エディット・ライブラリーが存在できます。

ユーザー提供の DSNHDECP モジュール: DSNH CLIST を使用可能にして、DB2

提供の DSNHDECP モジュールではなく、ユーザー提供の DSNHDECP モジュールをロードできるようにするには、以下のステップ必要です。

1. DSNH を呼び出す任意のジョブまたは TSO ユーザー ID の JOBLIB またはSTEPLIB との連結では、ユーザー提供の DSNHDECP モジュールが常駐するライブラリー (通常は、prefix.SDSNEXIT) を割り振ってから、DB2 提供のDSNHDECP モジュールが常駐するライブラリー (prefix.SDSNLOAD) を割り振る必要があります。

2. DSNH 呼び出しには PCLOAD パラメーターが組み込まれ、次のようにコード化されます。

PCLOAD(’*(DSNHPC)’)

リンク・エディット:

DSNH (TSO CLIST)


v DSNH は、追加のリンク・エディット制御ステートメントを必要とするプログラムの処理や、呼び出し接続機能を使用するプログラムのリンク・エディットを行うことができません。

v NOLOAD および SYNTAX リンク・エディット・オプションは使用できません。

NONE は予約語: NONE は、入力またはロード・ライブラリーの名前、あるいはPARMS により渡されるストリングの値としては使用できません。

SQL ホスト変数: SQL ホスト変数を明示的に定義する必要があります。

SYSPROC: コンパイルが終了している場合は、 SYSPROC データ・セットにはDB2 CLIST ライブラリーが組み込まれていなければなりません。

WORKUNIT パラメーター: DSNH CLIST をバッチ・モードで実行するときは、WORKUNIT パラメーターを使用する必要があります。こうすると、一時データ・セットならびに中間データ・セットが必ず正しい装置に割り振られます。

例例 1: データ・セット prefix.SDSNSAMP(DSN8BC4) に含まれる COBOL プログラムをプリコンパイル、バインド、コンパイル、リンク・エディット、および実行をします。v コンパイラー・ロード・モジュールは、SYS1.LINKLIB (IKFCBL00) にあります。

v 追加で組み込むロード・モジュールは、prefix.RUNLIB.LOAD およびprefix.SDSNSAMP にあります。

v ロード・モジュールはデータ・セット prefix.RUNLIB.LOAD(DSN8BC4) に入れられます。

v バインドと実行の場合のプラン名は、DSN8BC81 です。v プリコンパイルには、prefix.SRCLIB.DATA からの DCLGEN データが必要です。

この例では、DSNH CLIST が SYSPROC 連結内にあると仮定します。

DSNH INPUT(’prefix.SDSNSAMP(DSN8BC4)’’) -COBLOAD(’SYS1.LINKLIB(IKFCBL00)’’) -LLIB(’prefix.RUNLIB.LOAD’’) -L2LIB(’prefix.SDSNSAMP’’) -LOAD(’prefix.RUNLIB.LOAD’’) -PLAN(DSN8BC81) -PLIB(’prefix.SRCLIB.DATA’’)

例 2: データ・セット prefix.SDSNSAMP.PLI(DSN8BP4) に含まれるプログラムを、プリコンパイル、バインド、コンパイル、リンク・エディットします。v プログラムは PL/I で作成されているので、マクロ・パスは不要です。v PL/I コンパイラー・オプションである MAP と LIST が使用されます。v 追加で組み込むロード・モジュールは、prefix.RUNLIB.LOAD および

prefix.SDSNSAMP にあります。v PL/I 最適化コンパイラーのロード・モジュールは、ライブラリー

SYS2.LINKLIB(IEL0AA) 内にあります。v DB2 サブシステム ID は、SSTR です。v ロード・モジュールはデータ・セット prefix.RUNLIB.LOAD(DSN8BC4) に入れられます。

DSNH (TSO CLIST)


v 印刷出力が、以下のデータ・セットへ送られます。

出力データ・セットプリコンパイラー・リスト prefix.PROG.PCLIST

コンパイラー・リスト prefix.PROG.LIST

リンク・エディット・リスト prefix.PROG.LINKLIST

v バインドと実行の場合のプラン名は、DSN8BC81 です。v プリコンパイルには、prefix.SRCLIB.DATA からの DCLGEN データが必要です。

DSNH INPUT(’prefix.SDSNSAMP(DSN8BP4)’’) -HOST(PLI) MACRO(NO) -COPTION (’MAP LIST’) -LLIB(’prefix.RUNLIB.LOAD’’) -L2LIB(’prefix.SDSNSAMP’’) -PLILOAD(’SYS2.LINKLIB(IEL0AA)’’) -SYSTEM(SSTR) -LOAD(’prefix.RUNLIB.LOAD’’) -PRINT(PROG) -PLAN(DSN8BC81) -PLIB(’prefix.SRCLIB.DATA’’)

COPTION パラメーターは単一のアポストロフィで囲まれているので、それらはTSO により単一のパラメーターとして渡されます。単一のトークンをパラメーターとして渡す場合には、アポストロフィは不要です。同じ規則が、 PARMS およびCICSOPT パラメーターにも適用されます。

データ・セット名がパラメーターとして渡され、TSO にユーザー接頭部を追加させたい場合、アポストロフィは不要です。通常の TSO 接頭部および接尾部を使用できない場合は、CLIST を暗黙に実行するのであれば、データ・セット名を 3 つのアポストロフィのセットで囲む必要があります。CLIST を明示的に実行するには、 6

つのアポストロフィのセットで囲む必要があります。

この例のユーザー接頭部は prefix です。これが SMITH であれば、SMITH が最初のレベル修飾子として使用される場合を除き、データ・セット名のリストは上記の例のようになります。例えば、このコンパイラー・リストは SMITH.PROG.LIST のようになります。

例 3: DB2-C サンプル・アプリケーション・プログラム prefix.SDSNSAMP

(DSN8BD3) の呼び出し。

v C リンケージ・エディター組み込みライブラリーは EDC.V1R1M1.SEDCBASE です。

v C コンパイラーのロード・モジュールは EDC.V1R1M1.SEDCCOMP(EDCCOMP)

です。

v 印刷出力が、以下のデータ・セットへ送られます。

出力データ・セット

プリコンパイラー・リスト user_id.TEMP.PCLIST

コンパイラー・リスト user_id.TEMP.SYSCPRT.LIST

プリリンク・ユーティリティー・リストuser_id.TEMP.SYSOUT.PRELLIST

リンク・エディット・リスト user_id.TEMP.LINKLIST

v 次の C の DD 名は、PRINT キーワードの値に基づいて割り振られます。

DSNH (TSO CLIST)


DD 名割り振り

SYSCPRT コンパイル・ステップで使用される

SYSUT10 コンパイル・ステップで使用される

SYSOUT プリリンク・ステップで使用される

SYSUT10 および SYSCPRT は、常に同じデータ・セットまたは宛先に割り振られます。

v SYSTERM は、コンパイル・ステップで使用されます。これは、TERM キーワードに基づいています。

v CEEDUMP は、実行ステップで使用されます。これは、RUNOUT キーワードに基づいています。

v AMODE(31) および RMODE(ANY) の LOPTION キーワード値は、C サンプル・プログラムをリンク・エディットして、実行中の 31 ビット・アドレス可能度を確保するときに必要です。

ALLOC DD(SYSPROC) DSN(’prefix.SDSNCLST ’) SHR%DSNH BIND(YES) ACQUIRE(USE) ACTION(REPLACE)-EXPLAIN(NO) -CICSXLAT(NO) -COMPILE(YES) -CCLLIB(’EDC.V1R1M1.SEDCBASE’’)-CCLOAD(’EDC.V1R1M1.SEDCCOMP(EDCCOMP)’’)-DBRM(’prefix.DBRMLIB.DATA(DSN8BD3)’’)-DECIMAL(PERIOD) DELIMIT(DEFAULT) FLAG(I)-HOST(C) ISOLATION(RR)-INPUT(’prefix.SDSNSAMP(DSN8BD3)’’)-LINK(YES)-LLIB(’prefix.RUNLIB.LOAD’’)-L2LIB(’prefix.SDSNLOAD’’)-LOAD(’prefix.RUNLIB.LOAD’’)-LOPTION(’AMODE(31) RMODE(ANY)’)-MACRO(NO)-OUTNAME(TEMP)-PLAN(DSN8BD31) PRECOMP(YES)-PLIB(’prefix.SDSNSAMP’’)-PRELINK(NO)-POPTION(NONE)-PRINT(TEMP) RCTERM(8)-RELEASE(COMMIT) RETAIN(YES)-RUN(NO) RUNIN(TERM)-RUNOUT(TERM) SOURCE(YES)-SYSTEM(DSN) SQLDELIM(DEFAULT)-VALIDATE(RUN)

DSNH (TSO CLIST)


DSNH (TSO CLIST)


第 42 章 END (DSN)

DSN サブコマンド END は、DSN セッションを終了して TSO に戻るのに使用します。


v 『環境』

v 『許可』

v 『構文』

v 『使用上の注意』

v 『例』

環境このサブコマンドは、DSN がバックグラウンドまたはフォアグラウンドのいずれかのモードで実行中に TSO 入力ストリームから出されます。



構文

�� END ��

使用上の注意バッチまたはフォアグラウンドで DSN セッションを終了する: バッチにおいて、END が SYSIN ストリームにない場合、/* または // で DSN セッションが終了します。フォアグラウンドからであれば、ATTENTION キーを 2 回押すと DSN セッションが終了します。

例DSN セッションを終了し、TSO へ戻ります。

TSO prompt : READYUSER enters: DSN SYS (SSTR)DSN prompt : DSN


USER enters: RUN PROGRAM (MYPROG)DSN prompt : DSNUSER enters: ENDTSO prompt : READY

END (DSN)


第 43 章 FREE PACKAGE (DSN)

DSN サブコマンド FREE PACKAGE は、パッケージの特定のバージョン、パッケージのすべてのバージョン、またはパッケージのコレクション全体を削除するときに使用できます。

FREE PACKAGE サブコマンドは、対応する表項目をカタログ表から削除します。パッケージ名についての許可が除去されるのは、パッケージのすべてのバージョンがなくなったときに限られます。パッケージのバージョンが解放されると、そのパッケージ名を BIND PACKAGE サブコマンドで使用して新しいパッケージを作成できるようになります。

FREE PACKAGE サブコマンドは、そのパッケージを使用して現在実行中のアプリケーションがすべて実行を終了するまでは処理を継続しません。

パッケージについて詳しくは、「DB2 アプリケーション・プログラミングおよびSQL ガイド」第 5 部を参照してください。


v 『環境』

v 『許可』





環境このサブコマンドは DB2I から、あるいはフォアグラウンドかバックグラウンドで実行している TSO 下の DSN セッションから入力できます。


許可このサブコマンドを実行するには、次の特権または権限のいずれかを含む処理の特権セットを使用する必要があります。v パッケージの所有権v パッケージの所有者から授与された BINDAGENT 特権v SYSCTRL 権限v SYSADM 権限v 該当のコレクション、またはすべてのコレクションに対する PACKADM 権限

パッケージに対する BIND 特権は、ユーザーがパッケージを解放するには十分ではありません。


構文

�� FREE PACKAGE �

� �

,

( collection-id . package-id )location-name. * * .( )

version-id*

*

�

�I

FLAG( W )EC

��

オプションの説明location-name

パッケージの解放が行われる DBMS のロケーションを指定します。ロケーション名は、SYSIBM.LOCATIONS 表で定義されている必要があります。この表が存在しないか、DBMS が見つからない場合は、エラー・メッセージが出されます。ロケーション名を指定する場合は、ローカル DB2 サブシステムの名前を定義する必要があります。SYSIBM.LOCATIONS 内でロケーション名を定義する方法については、「DB2 インストレーション・ガイド」第 3 部を参照してください。

location-name を省略した場合のデフォルトは、ローカル DB2 サブシステムです。

collection-id または (*)解放するパッケージのコレクションを識別します。デフォルトはありません。

アスタリスク (*) を使用すれば、ユーザーが解放する許可を有しているすべてのコレクション内の指定された package-id をもつすべてのローカル・パッケージを解放できます。(リモート・パッケージを解放するのに * は使用できません。)

package-id または (*)解放するパッケージを識別します。デフォルトはありません。

アスタリスク (*) を使用すれば、ユーザーが解放する許可を有しているcollection-id をもつすべてのローカル・パッケージを解放できます。(リモート・パッケージを解放するのに * は使用できません。)

version-id または (*)解放するパッケージのバージョンを識別します。

FREE PACKAGE (DSN)


アスタリスク (*) を使用すれば、ユーザーが解放する許可を有しているcollection-id および package-id をもつすべてのローカル・パッケージを解放できます。(リモート・パッケージを解放するのに * は使用できません。)

version-id に () を指定すると、バージョン ID に空ストリングが使用されます。

version-id を省略した場合、デフォルトは package-id を指定した方法によって異なります。package-id に * を使用すると、version-id のデフォルトも * となります。また、package-id に明示値を指定すると、version-id のデフォルトは空ストリングになります。

DB2 バージョン 2 リリース 3 より前に作成された DBRM では、空ストリングを version-id のデフォルトとして使用します。

(*)ユーザーが解放する許可を有している、すべてのローカル DB2 パッケージを解放します。

(*) を指定することは、そのパッケージ名を (*.*.(*)) または (*.*) として指定することと同等です。

FLAGどのメッセージをシステムに表示させるかを示します。対応するタイプのメッセージを表示するには、下記のいずれかの値を使用してください。

(I) すべて: 通知、警告、エラー、および完了の各メッセージ。



(C) 完了メッセージのみ。

使用上の注意複数パッケージの解放: このサブコマンドを使用して複数のパッケージを解放する場合、正常に行われた各解放処理は次のパッケージを解放する前にコミットされます。

明示的にリストで指定された、あるいは (*) で暗黙に指定された特定のパッケージにエラーが生じた場合、そのパッケージに対しては FREE PACKAGE が終了し、次のパッケージに処理が移動します。

トリガー・パッケージの解放: FREE PACKAGE サブコマンドを使用してトリガー・パッケージを解放することはできません。

トリガーのドロップについて詳しくは、「DB2 SQL 解説書」第 5 章を参照してください。

FREE PACKAGE (DSN)

第 43 章 FREE PACKAGE (DSN) 295

例例 1: USIBMSTODB22 に存在するパッケージ TEST.DSN8BC81 の newver バージョンを解放します。メッセージは警告、エラー、完了のみを生成します (通知メッセージは生成しない)。

FREE PACKAGE (USIBMSTODB22.TEST.DSN8BC81.(newver)) FLAG(W)

例 2: TESTCOLLECTION という名前のコレクション内のローカル・サーバーのすべてのパッケージを解放します。

FREE PACKAGE (TESTCOLLECTION.*)

FREE PACKAGE (DSN)


第 44 章 FREE PLAN (DSN)

DSN サブコマンド FREE PLAN は、DB2 からアプリケーション・プランを削除するときに使用します。

FREE PLAN サブコマンドは、対応する表項目を SYSIBM.SYSPLAN カタログ表から削除します。アプリケーション・プラン名に対する許可は、すべて除かれます。この結果、そのアプリケーション・プラン名を BIND PLAN サブコマンドで使用して、新しいパッケージを作成できるようになります。

FREE PLAN サブコマンドは、そのプランを使用している現在実行中のアプリケーションがすべて実行を終了するまでは先へ進みません。

プランについて詳しくは、「DB2 アプリケーション・プログラミングおよび SQL

ガイド」第 5 部を参照してください。


v 『環境』

v 『許可』





環境このサブコマンドは DB2I から、あるいはフォアグラウンドかバックグラウンドで実行している TSO 下の DSN セッションから入力できます。


許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v プランの所有権v プランに対する BIND 特権v プラン所有者から授与された BINDAGENT 特権v SYSCTRL 権限v SYSADM 権限


構文

�� FREE PLAN �

,

( plan-name )* I

FLAG( W )EC

��

オプションの説明(plan-name, ...)解放する 1 つ以上のプランの名前をリストします。

(*) 自分が BIND 権限を有するすべてのアプリケーション・プランを解放します。コマンドをこの形式で使用する場合は、注意が必要です。

FLAGどのメッセージをシステムに表示させるかを示します。対応するタイプのメッセージを表示するには、下記のいずれかの値を使用してください。

(I) すべて: 通知、警告、エラー、および完了の各メッセージ。



(C) 完了メッセージのみ。

使用上の注意複数のプランの解放: このサブコマンドで複数のプランを解放する場合、正常に行われた各解放処理は次のプランの解放前にコミットされます。

明示的にリストで指定された、あるいは (*) で暗黙に指定された特定のプランにエラーが生じた場合、そのプランに対しては FREE PLAN が終了し、次のプランに処理が移動します。

例プラン DSN8BC81 を DB2 から解放します。メッセージは警告、エラー、完了のみを生成します (通知メッセージは生成しない)。

FREE PLAN (DSN8BC81) FLAG (W)

FREE PLAN (DSN)


第 45 章 MODIFY irlmproc,ABEND (z/OS IRLM)

MODIFY irlmproc,ABEND コマンドは、IRLM を異常終了させます。IRLM は、DB2 サブシステムが IRLM に識別されている場合でも、このコマンドを処理します。

省略形: F


v 『環境』

v 『許可』

v 『構文』




環境このコマンドは、z/OS コンソールからのみ発行できます。


許可このコマンドには適切なレベルのオペレーティング・システム権限が必要であり、これについては「z/OS MVS システム・コマンド」に説明があります。

構文

�� MODIFYDUMP

irlmproc,ABEND,NODUMP

��

オプションの説明パラメーターは、スペースなしのコンマで区切る必要があります。

irlmproc

終了させる IRLM のプロシージャー名を指定します。

DUMPIRLM が U2020 アベンドで異常終了することを示します。SYS1.DUMPxx データ・セットにシステム・ダンプが取られます。IRLM は ARM からの登録をはずしません。


NODUMPIRLM が DBMS のオフを強制 (FORCE) し、ダンプを生成せずに正常終了することを指定します。すべての DBMS 作業は静止され、IRLM は自分自身を停止します。NODUMP では、IRLM が正常に機能している必要があります。 IRLM

がハング状態と思われる場合は、このオプションを使用ないでください。

2 番目の呼び出しにより、IRLM は U2020 アベンドで異常終了し、ダンプは取られません。

使用上の注意IRLM の終了: IRLM の終了が困難な場合は 442ページの『使用上の注意』を参照してください。

IRLM の登録抹消: NODUMP オプションを使用して、IRLM を停止する前に登録をはずすことができます。この処理により、自動リスタート管理機能が即時に IRLM

を再始動しようとするのを防ぐことができます。

例システム・コンソールで次のコマンドを入力します。

F KRLM001,ABEND

z/OS システム・コンソールに次のような応答があります。

DXR124E IR21001 ABENDED VIA MODIFY COMMAND*IEA911E COMPLETE DUMP ON SYS1.DUMP00

FOR ASID(0004)ERROR ID = SEQ00001 CPU00 ASID0004 TIME08.34.59.9

DXR121I IR21001 END-OF-TASK CLEANUP SUCCESSFULIEF450I IR21001 IR21001 - ABEND=S000 U2020 REASON=00000000

デフォルトはダンプ (DUMP) です。ダンプが不要な場合は、次のコマンドを指定する必要があります。

F KRLM001,ABEND,NODUMP

MODIFY irlmproc,ABEND (z/OS IRLM)


第 46 章 MODIFY irlmproc,DIAG (z/OS IRLM)

MODIFY irlmproc,DIAG コマンドは、IRLM サブシステムの診断ダンプを開始します。

IRLM は、子へのロック伝搬処理に遅れを検出すると、リカバリーのために XES

呼び出しを再試行します。この状態が発生した場合は、IBM ソフトウェア・サポートの指示のもとで MODIFY irlmproc,DIAG コマンドを使用します。

省略形: F


v 『環境』

v 『許可』

v 『構文』







構文

�� MODIFY irlmproc,DIAG ,DELAY,PLOCK,ALL,NONE,HANG

��

オプションの説明パラメーターは、スペースなしのコンマで区切る必要があります。

irlmproc

診断する IRLM インスタンスのプロシージャー名を指定します。


|

|

|

||||||||||||||||||||||||||

|

DIAGこれが診断ダンプであることを指定します。

DELAYカップリング・ファシリティーへの子ロック伝搬が 45 秒より長くかかっていることを最初に検出した時に、ダンプを生成するように IRLM に指示します。ダンプは SYS1.DUMPxx データ・セットに置かれます。

PLOCKP-lock 交渉が 2 分よりも長くかかっていることを最初に検出した時点で、ダンプを生成するように IRLM に指示します。IRLM および DB2 アドレス・スペースのダンプが SYS1.DUMPxx データ・セット内に入ります。

ALL次の異常状態の場合に、データ共用グループの IRLM または DBMS サブシステムについて、診断ダンプを生成するように IRLM に指示します。

v P-lock ネゴシエーションが 2 分よりも長くかかっている。

v 子ロックの伝搬が 45 分よりも長くかかっている。

v IRLM は、子ロックの伝搬処理に遅れを検出すると、リカバリーのためにXES 呼び出しを再試行します。

NONEすべての診断ダンプの生成を不可能にします。

HANGDEADLOCK または TIMEOUT 問題の疑いがある場合、IRLM SYSPLEX ダンプを収集します。ダンプは DEADLOCK 処理中に取られます。DEADLOCK 処理が停止され、動的デッドロック・ストレージが収集されます。次に z/OS

DUMP サービスは、DEADLOCK 処理を再開するように SRB をスケジュールします。DEADLOCK 処理が再開されると、各 IRLM によってメッセージDXR183I が出されます。IRLM がメッセージ DXR183I を出さない場合は、その IRLM を終了し、再始動する必要があります。IRLM XCF CTRACE は内部で開始し、30 秒待ってから、このコマンドを実行する必要があります。

使用上の注意MODIFY irlmproc,DIAG コマンドは、IBM ソフトウェア・サポートの指示のもとでのみ使用してください。

このコマンドは、IRLM 当たり 1 つの問題についてのみアクティブ状態 (つまり、IRLM インスタンスが遅れを検出した後で) であり、ダンプを開始します。グループ内の IRLM ごとに 1 つのダンプを開始することができます。別のダンプを開始するには、コマンドを再度入力する必要があります。このコマンドをデータ共用グループの 1 つのメンバーに入力すると、この遅れを検出したすべてのメンバーがダンプを開始することに注意してください。

irlmproc は IRLM のプロシージャー名を識別します。同じシステムに複数の IRLM

インスタンスが存在する場合、各プロシージャーは固有の名前を持つ必要があります。



|

|

|

|

|

|

|

|

|

|

|

|

|

例このコマンドを発行して、IR21PROC IRLM サブシステムに対して 1 つの診断ダンプを開始します。子ロックの伝搬が 45 秒より長くかかった後に、ダンプが 1 回起こります。

MODIFY IR21PROC,DIAG,DELAY


第 46 章 MODIFY irlmproc,DIAG (z/OS IRLM) 303

第 47 章 MODIFY irlmproc,PURGE (z/OS IRLM)

MODIFY irlmproc,PURGE コマンドは、DB2、IRLM、またはシステムの障害のためにかけられたままになっている IRLM のロックを解放します。このコマンドは、指定された DB2 に対してかけられたすべてのロックをシステムから削除するので、更新のためにそれらを使用できるようになります。ロックがかけられていると、更新されたリソースが保護されるので、これを使用するときは、リソースが何であるか、もしそれを削除したらデータ保全性にどのような影響があるかをよく理解した上で行ってください。

省略形: F


v 『環境』

v 『許可』

v 『構文』

v 『構文』






構文

�� MODIFY irlmproc,PURGE,db2name ��

オプションの説明パラメーターを区切るには、スペースを入れずにコンマを使用します。

irlmproc

コマンドを処理するアクティブ IRLM を指定します。


#

db2name

STATUS コマンドによって表示される非アクティブ DB2 名を指定します。

使用上の注意DB2 サブシステムを非アクティブにする: かけられたロックを所有している DB2

サブシステムは、非アクティブでなければなりません。そのようにしないと、このコマンドは失敗に終ります。

irlmproc には、障害が起こったメンバーと同じシスプレックス・グループに接続された、アクティブ IRLM のプロシージャー名にする必要があります。非アクティブIRLM を使用して除去要求を出すと、エラー IEE341I が戻されます。

例例: irlmproc 名 db2birlm を持つ db2b というアクティブ DB2 サブシステムの場合、次のコマンドを出すと、データ共用シスプレックス内のすべてのアクティブ・サブシステムおよび非アクティブ・サブシステムが表示されます。

F db2birlm,STATUS,ALLD

サブシステム db2a が非アクティブな場合、次のコマンドを入力します。

F db2birlm,PURGE,db2a

除去要求が完了した場合、MVS システム・コンソールに次のような応答があります。

DXR109I IR2B002 PURGE COMMAND COMPLETED FOR DB2A

説明: シスプレックス環境では、DB2 データベースが非アクティブの場合にデータベース IRLM が停止したり、切断されると、z/OS システムのオペレーターは他のアクティブ IRLM メンバーのいずれかを使用して、保持ロックがあるか照会し、PURGE 要求を出します。

MODIFY irlmproc,PURGE (z/OS IRLM)


#

#

#

#

#

#

#

#

#

#

#

#

#

#

#

#

#

第 48 章 MODIFY irlmproc,SET (z/OS IRLM)

MODIFY irlmproc,SET コマンドは次の作業を実行します。

v IRLM から許される最大私用記憶域を動的にセットする

v IRLM に許されるトレース・バッファーの数を動的にセットする

v XCF LOCK 構造への次の接続で指定される LOCK LTE 項目数を動的にセットする

v 指定のサブシステムに対するタイムアウト値を動的にセットする

v ローカル・デッドロック頻度を動的にセットする

省略形: F


v 『環境』

v 『許可』

v 『構文』





データ共用範囲: グループまたはメンバー。DEADLOCK または LTE オプションのどちらを指定するかによって異なります。


構文

�� MODIFY irlmproc,SET ,DEADLOCK=nnnn,LTE=nnnn,MLT=nnnnnU,PVT=nnnn,TIMEOUT=nnnn,subsystem-name

10,TRACE= nnn

��


|

|

|

||||||||||||||||||||||||||||||||||||

|

オプションの説明パラメーターを区切るには、スペースを入れずにコンマを使用します。

irlmproc

コマンドを処理する IRLM を指定します。

SETこの IRLM に対して以下の値をセットします。

DEADLOCK=nnnn

ローカル・デッドロック処理をスケジュールする頻度を示す数値 (ミリ秒) を指定します。nnnn は、100 ～ 5000 ミリ秒の範囲の数値でなければなりません。シスプレックス・グループのメンバーとすべての IRLM

が、ミリ秒単位デッドロック処理が使用可能ではない場合、メッセージDXR106E が出されます。

LTE=nnnn

XCF ロック構造への次の接続で指定されるロック表エントリー数を指定します。nnnn は、0 から 1024 までの数値で、2 の偶数乗でなければなりません。それぞれの値の増分は、1 048 576 LTE エントリー数を表します。このパラメーターは、データ共用の場合にのみ使用されることに注意してください。

MLT=nnnnU

2 GB 境界の上の専用ストレージの上限を指定します。MEMLIMIT とも呼ばれ、MVS によって管理されます。このコマンドを使用すると、IRLM の MEMLIMIT を動的に変更できます。このストレージは、ロックに使用されます。値 nnnnn は 0 から 99999 の 5 桁の数値でなければなりません。また U は、メガバイトの場合は M、ギガバイトの場合は G、テラバイトの場合は T、ペタバイトの場合は P の値の、1 文字の単位標識でなければなりません。IRLM に指定された MEMLIMIT

は、最小 2 GB と、コマンドの実行時に使用される、境界より上のストレージ量の両方よりも大きくなければなりません。指定された値が範囲外かまたは使用する量 (または最小 2 GB) より小さい場合、コマンドはリジェクトされてメッセージ DXR106E が出されます。このMEMLIMIT の更新は一時的で、この IRLM インスタンスの実行中のみ保持されます。MEMLIMIT の変更を永続にするには、MEMLIMIT JCL

EXEC パラメーターの新しい値で対応する IRLM 開始プロシージャーを更新します。

PVT=nnnn

2 GB 境界より下の専用ストレージの上限を指定します。nnnn は、1 から 1800 までの 4 桁の数値でなければなりません。この値は、メガバイトまたはギガバイトの単位で指定できます。そのためには、nnnnM または nnnnG のように、値の後に M (メガバイトの場合) または G (ギガバイトの場合) を指定します。IRLM は、ロックに使用された専用ストレージ量をモニターします。指定された限度に達した場合、新規ロック要求は、コンプリート必須である場合を除き、リジェクトされます。この指定値が許容範囲外であるか、または IRLM による私用記憶域の使用量がすでに指定値を超えている場合は、コマンドがリジェクト



|

|

|

|

|

|

|

|

|

|

されてメッセージ DXR106E が出されます。コンプリート必須ロック用の予約量は、指定された PVT= 値からは計算されません。

TIMEOUT=nnnn,subsystem-name

指定のサブシステムに対するタイムアウト値 (秒数) を、IRLM が動的にセットするように要求します。nnnn は、1 から 3600 までの数値であることが必要です。subsystem-name は、MODIFY irlmproc,STATUS

コマンドで表示される DB2 サブシステム名です。

TRACE=nnn

IRLM がトレース・タイプごとの 64KB トレース・バッファーの最大数を、 nnn にセットされた値に動的にセットするように要求します。nnn

は 10 ～ 255 の数でなければなりません。指定した値がこの範囲外にある場合は、 IRLM は範囲内の値になるように自動的に値を調整します。


この値は、外部 CTRACE 書き出しプログラムがアクティブでない場合にのみ使用されます。トレース・バッファーは、拡張共通記憶域(ECSA) から割り振られます。

IRLM は、このコマンドを使用してセットされたトレース・バッファー数をすぐには取得しません。IRLM は、指定されたバッファー数を超えない範囲で、必要に応じてバッファーを割り振ります。セットしたトレース・バッファー数が、現在割り振られているバッファー数より少ない場合、IRLM は次のデッドロック・サイクルの終わりに、最も古いバッファーを解放し、指定された範囲内の数になるようにします。

使用上の注意IRLM 再始動の影響: MODIFY irlmproc,SET コマンドでセットした値は、IRLM の停止と再始動にまたがって持続することはありません。各トレース・タイプごとのトレース・バッファーの数は、デフォルト値の 10 に戻ります。

TIMEOUT の考慮事項: TIMEOUT 値は、ローカル・デッドロック・パラメーターの倍数にする必要があります。入力された値が、デッドロック・パラメーターの偶数倍でないと、IRLM は、タイムアウト値を次の最も高い倍数に増やします。この新しい値は、IRLM または識別されたサブシステムが終了するか、またはオペレーターがタイムアウトを再び変更するまで、使用されます。このコマンドで指定する値は、DB2 zparms のタイムアウト値に影響を与えません。

LTE パラメーターの効果: この IRLM はグループには接続されていないが、有効な値が指定されている場合は、値が設定されているが、その値が他のどのメンバーにも送信されない、というメッセージが出されます。そのメンバーがすでにグループに含まれている場合は、この値が IRLM の Global Deadlock Manager (GDM) に送信され、他のすべてのメンバーにブロードキャストされます。GDM にそのコードが適用されていない場合は、どのメンバーにも応答メッセージは出されません。GDM にこのコードがある場合は、コマンド処理時に、適用されたコードのあるすべてのメンバーが応答メッセージを出します。IRLM がデータ共用グループと最初に結合する場合は、この値が使用され、構造の割り振りが行われるか、またはREBUILD 時にこの値が使用されます。後で結合する任意の IRLM は、更新された


第 48 章 MODIFY irlmproc,SET (z/OS IRLM) 309

|

値を持つことはありません。同じまたは複数の IRLM で複数の MODIFY コマンドが発行されると、応答メッセージが出されないことがあります。発行された最後の応答メッセージが、次の CONNECT で使用される値を識別します。

グループのロック表エントリー数は、初期構造割り振り時または REBUILD 時にグループに接続する最初の IRLM によって決まります。

LTE 値は、次の順序で使用されます。

1. MODIFY irlmproc,SET,LTE= コマンドを使用して指定された値 (値がゼロより大きい場合)。

2. IRLMPROC の LTE= からの値 (値がゼロより大きい場合)。

3. 既存の論理によって決定された値。この値は、XESQUERY 呼び出しで戻されたXES 構造サイズを LTE 幅の 2 倍で除算します。その結果を最も近隣の 2 の累乗に丸めます。既存の論理はこれを値として使用します。

注: LTE 幅は、MAXUSRS 値によって決まります。

オプション番号 1 または 2 のいずれかの非ゼロ値を使用する場合に、その値がQUERY で戻される構造サイズとして大きすぎる場合は、そのシーケンスにある次のオプションからの値が代わりに使用されます。

非サポート・メンバーのデッドロック値範囲: ミリ秒単位デッドロックをサポートする IRLM が結合したグループに、ミリ秒単位デッドロックをサポートしないメンバーが含まれているときに、新規メンバーのデッドロック値が 1 秒未満である場合、値は 1 秒にセットされます。

例例 1: z/OS システム・コンソールから次のコマンドを入力します。

F IR21PROC,SET,TRACE=20


DXR177I IR21033 THE VALUE FOR TRACE IS SET TO 20.

例 2: z/OS システム・コンソールから次のコマンドを入力します。

F IR21PROC,SET,TIMEOUT=60,DBMS


DXR177I IR21033 THE VALUE FOR TIMEOUT IS SET TO 60 FOR DBMS


F IR21PROC,SET,LTE=1024


DXR177I IR21033 THE VALUE FOR LTE IS SET TO 1024


F IR21I,SET,DEADLOCK=1000




|

|

|

|

|

|

|

|

|

DXR177I IR21033 THE VALUE FOR DEADLOCK IS SET TO 1000 MILLISECONDS

例 5: z/OS コンソールから次のコマンドを入力します。

F IR21I,SET,PVT=1000

z/OS システム・コンソールから次のような応答があります。

DXR177I IR21033 THE VALUE FOR PVT IS SET TO 1000

例 6: z/OS コンソールから次のコマンドを入力します。

F IR21I,SET,MLT=4G

z/OS システム・コンソールから次のような応答があります。

DXR177I IR21033 THE VALUE FOR MLT IS SET TO 4G


第 48 章 MODIFY irlmproc,SET (z/OS IRLM) 311

|

|

|

第 49 章 MODIFY irlmproc,STATUS (z/OS IRLM)

このコマンドは、irlmproc を使用して指定された IRLM に接続済みの 1 つ以上のサブシステムに関する情報を表示します。指定された IRLM に接続済みの各サブシステムがリストされます (サブシステム名、状況、作業単位、ロック情報と、IRLM

TIMEOUT および DEADLOCK パラメーター値の現行値を含む)。さらに、IRLM

の ID およびサービス・レベルをリストすることができます。指定された IRLM について、現在割り振られている記憶域だけでなく、この IRLM が最後に開始した後で割り振られた記憶域の最大量も表示することができます。

省略形: F


v 『環境』

v 『許可』

v 『構文』





データ共用範囲: メンバーまたはグループ。選択したオプションにより異なります。

許可このコマンドには適切なレベルの z/OS 権限が必要であり、これについては「z/OS

MVS システム・コマンド」で説明しています。

構文

�� MODIFY,irlmx

irlmproc,STATUS,ALLD,ALLI,MAINT,STOR,TRACE

��


オプションの説明irlmproc

コマンドを処理する IRLM を指定します。

irlmx

どの IRLM 状況を表示するかを指定します。irlmx は、IRLM サブシステム名と IRLM 始動プロシージャー (DB2 インストール・パネル DSNTIPI) に指定されている IRLM メンバー ID とを連結したものです。DJ2A2 はその一例です(メンバー ID は 2)。

ALLDIRLM に識別されている DB2 の DB2 サブシステム名と状況を要求します。データ共用グループにおいて、このコマンドが出された IRLM がそのデータ共用グループに接続されていると仮定すると、このコマンドは、現在 IRLM に識別されているすべての DB2 サブシステムの情報をリストします。IRLM が接続されているかどうかは、 MODIFY irlmproc,STATUS コマンドを出し、出力にSCOPE=GLOBAL が示されていることを検査すれば判別できます。

DB2 が停止しており、保持ロックが保留状態の場合、その DB2 も表示されます。ただし、その DB2 と一緒に表示される IRLM は、いくつかの環境によって異なります。

v 通常、それは DB2 サブシステムが識別された最後の IRLM です。

v 保持ロックが作成された後でロック構造が再作成された場合、再作成が行われた時点で最も低いメンバー ID を持つ IRLM が表示されます。

v あるグループ再始動が発生している状態で、ある DB2 サブシステムが別DB2 サブシステムに代わってリカバリーしていた場合、表示される IRLM

は、対等リカバリーを行っている DB2 サブシステムに関連した IRLM です。例えば、DB1A が DB2A の対等リカバリーを行っている場合、次の情報が表示されます。

NAME STATUS ... IRLM_NAMEDB1A UP IRLADB2A DOWN IRLA

ALLIIRLM サブシステム名、ID、状況、およびサービス・レベルを要求します。データ共用グループにおいては、このコマンドが出された IRLM がそのデータ共用グループに接続されている場合、このコマンドは、すべての IRLM サブシステムに関する情報をリストします。IRLM が接続されているかどうかは、MODIFY irlmproc,STATUS コマンドを出し、出力に SCOPE=GLOBAL が示されていることを検査すれば判別できます。

IRLM が停止している場合は、その IRLM に関連した DB2 サブシステムが停止し、保持ロックが保留状態の場合にのみ、その IRLM が表示されます。表示される IRLM は、いくつかの環境によって異なります。

v 通常、それは DB2 サブシステムが識別された最後の IRLM です。

v 保持ロックが作成された後でロック構造が再作成された場合、再作成が行われた時点で最も低いメンバー ID を持つ IRLM が表示されます。



v 失敗した DB2 サブシステムに代わって別 DB2 サブシステムがリカバリーを行った場合、表示される IRLM は、対等リカバリーを行った DB2 サブシステムに関連した IRLM です。

MAINTこの IRLM のみに関して、IRLM ロード・モジュール CSECTS の保守レベルを 2 列フォーマットで表示します。

STORこの IRLM の場合にのみ、CSA、ECSA、および私用拡張記憶域の現行割り振りと最大割り振りを表示します。

TRACEIRLM サブコンポーネントのトレース・タイプの情報を要求します。情報には、サブコンポーネント・トレース・タイプがアクティブであるか、トレースによっていくつのトレース・バッファーが使用されているか、およびコンポーネント・トレース外部書き出しプログラムがトレース用にアクティブであるか、が含まれます。

使用上の注意メッセージ: irlmx が指定されていないか、この IRLM が非データ共用環境にある場合は、メッセージ DXR101I が出されます。このメッセージは、irlmx によって指定された IRLM に接続した各サブシステムを、接続がアクティブかどうかの標識付きでリストします。

IRLM ID の表示: SCOPE=GLOBAL を指定して irlmproc を開始した場合、表示の2 行目には IRLM サブシステムの IRLM ID が示されます。

例例 1: z/OS システム・コンソールから次のコマンドを入力します。

MODIFY IRTPROC,STATUS


DXR101I IR2T001 STATUS SCOPE=LOCALDEADLOCK: 0500

SUBSYSTEMS IDENTIFIED PT01NAME T/OUT STATUS UNITS HELD WAITING RET_LKSDSNT1 0010 UP-NS 0005 0010 0002 0

説明: z/OS システムのオペレーターは、DB2 に関する情報を要求しています。このシステムは、 IRTPROC という名前の IRLM プロシージャーで示される IRLM に接続しています。

IRLM が irlmproc で SCOPE=GLOBAL と指定されていてどのグループにも接続していない場合は、以下の状況メッセージが表示されます。

DXR101I IR21001 STATUS SCOPE=DISCON

その他の情報には次のものがあります。

DEADLOCKIRLM のデッドロック検出の間隔時間。この値はミリ秒単位です。


第 49 章 MODIFY irlmproc,STATUS (z/OS IRLM) 315

#####

#

#

#

#

#

T/OUTリソース・タイムアウトに対して、DBMS によって指定されたタイムアウト値。この値は秒単位です。

STATUSDB2 サブシステムの状況を示します。

UP STATUS フィールドの値 UP は、DB2 サブシステムがアクティブであることを示します。

DOWN STATUS フィールドの値 DOWN は、DB2 サブシステムに障害があることを示します。この DB2 サブシステムが保持しているすべての変更タイプのロックは IRLM により保存されました。DB2 サブシステムが停止状態であると分かるのは、IRLM が保持ロックを持っている場合だけです。

RET_LKSこの DB2 サブシステムが所有している保持ロックの数。

例 2: データ共用グループがあるものと想定します。システム・コンソールで次のコマンドを入力します。

MODIFY DB1GIRLM,STATUS,ALLD

システム・コンソールに次のような応答があります。

11.11.07 STC00061 DXR102I DJ1G001 STATUS CSUBSYSTEMS IDENTIFIEDNAME STATUS RET_LKS IRLMID IRLM_NAME IRLM_LEVLDB1G UP 0 001 DJ1G 2.022DB2G UP 0 002 DJ2G 1.022

DXR102I End of display

説明: 出力結果には、このデータ共用グループ (要求を処理する IRLM が属しているグループ) に属する IRLM に接続されたすべての DB2 サブシステムが表示されます。その他の情報には次のものがあります。

STATUSDB2 サブシステムの状況を示します。

UP STATUS フィールドの値 UP は、DB2 サブシステムがアクティブであることを示します。

DOWN STATUS フィールドの値 DOWN は、DB2 サブシステムに障害があることを示します。この DB2 サブシステムが保持しているすべての変更タイプのロックは IRLM により保存されました。DB2 サブシステムが停止状態であると分かるのは、IRLM が保持ロックを持っている場合だけです。

SYSFAIL STATUS フィールドの値 SYSFAIL は、DB2 サブシステムを識別している IRLM が、データ共用グループから切断されていることを示します。この DB2 サブシステムが保留しているすべての変更タイプのロックは IRLM により保存されます。この DB2 サブシステムが SYSFAIL 状態であると分かるのは、IRLM が保持ロックを持っている場合だけです。



#

#

#

||||||

RET_LKSこの DB2 サブシステムが所有している保持ロックの数。

IRLMIDこの DB2 サブシステムが識別されている IRLM の ID。

IRLM_NAMEこの DB2 サブシステムが識別されている IRLM 名。

IRLM_LEVLこの DB2 サブシステムが IRLM への識別時に要求した IRLM リリースおよび機能レベル。これは r.fff の形式になっています。

例 3: データ共用グループの特定メンバーに関する情報を表示するには、次のコマンドを入力します。

MODIFY DB1GIRLM,STATUS,DJ1G002

システム・コンソールに次のような応答があります。

11.11.21 STC00061 DXR102I DJ1G001 STATUS CSUBSYSTEMS IDENTIFIEDNAME STATUS RET_LKS IRLMID IRLM_NAME IRLM_LEVLDB1G UP 0 002 DJ1G 2.022


説明: この出力は、例 1 に示されている出力と類似した情報を表示していますが、このコマンドではデータ共用グループの特定 IRLM を指定しています。

例 4: この例でも、データ共用が有効であるものとします。システム・コンソールで次のコマンドを入力します。

MODIFY DB1GIRLM,STATUS,ALLI

システム・コンソールに次の応答があります。

11.11.00 STC00061 DXR103I DJ1G001 STATUS CIRLMS PARTICIPATING IN DATA SHARING GROUP FUNCTION LEVEL=1.022IRLM_NAME IRLMID STATUS LEVEL SERVICE MIN_LEVEL MIN_SERVICE

DJ1G 001 UP 2.022 HIR2220 2.022 HIR2220DJ2G 002 UP 1.022 PQ52360 1.012 PN90337


説明: この出力には、このデータ共用グループ (要求を処理している IRLM が含まれているグループ) に参加している複数の IRLM を表示しています。その他の情報には次のものがあります。

STATUSSTATUS フィールドの「UP」という値は、その IRLM がアクティブであることを示します。IRLM に障害があると STATUS には「DOWN」が表示されます。IRLM が「DOWN」していることが分かるのは、それに対して識別されている DB2 サブシステムが保持ロックを持っている場合のみです。失敗した DB2 サブシステムと IRLM の間のこの接続は、REBUILD またはグループ再始動の後に失われます。

LEVEL現行の IRLM リリースおよび機能レベル (r.fff の形式)。



SERVICE″LEVEL″ で指定されたリリースおよび機能レベルに対応する IRLM サービスまたはリリース。

MIN_LEVELこの IRLM が共存できる最小 IRLM 機能レベル。

MIN_SERVICE″MIN-LEVEL″ で指定された機能レベルに対応する IRLM サービスまたはリリース。

GROUP FUNCTION LEVELデータ共用グループ内のすべての IRLM により使用されている IRLM リリースおよび機能レベル。

例 5: このコマンドが非データ共用環境で出されたと想定しています。システム・コンソールで次のコマンドを入力します。

MODIFY DB1GIRLM,STATUS,ALLI


11.11.03 STC00082 DXR103I DJ1G001 STATUS CIRLMS PARTICIPATING IN DATA SHARING GROUP FUNCTION LEVEL=2.022IRLM_NAME IRLMID STATUS LEVEL SERVICE MIN_LEVEL MIN_SERVICE

DJ1G 001 UP 2.022 HIR2220 1.022 PQ523690DXR103I End of display

説明: この出力では、指定された IRLM のみに関する情報を表示しています。表示されているグループ機能レベルは、指定された IRLM の機能レベルです。出力の解釈について詳しくは、 317ページの例 4 を参照してください。

例 6: システム・コンソールで次のコマンドを入力します。

MODIFY IR21PROC,STATUS,STOR


DXR100I PR21001 STOR STATS 150PC: YES LTEW: 32 LTE: OM RLE: 3046 RLEUSE: 0

BB PVT: 1738M AB PVT (MEMLIMIT): 2GCSA USE: ACNT: OK AHWM: OK CUR: 312K HWM: 312KABOVE 16M 15 312K BELOW 16M: 0 0K

CLASS TYPE SEGS MEM TYPE SEGS MEM TYPE SEGS MEMACCNT T-1 1 2048K T-2 1 1024K T-3 1 4KPROC WRK 4 20K SRB 1 1K OTH 1 1KMISC VAR 7 733K N-V 10 247K FIX 1 24KDXR100I END OF DISPLAY

説明: この例は、IRLM に割り振られた現行記憶域が 312 KB であること、および最後に IRLM が開始してから割り振られた最大量も 312 KB であることを示しています。ロッキング構造のための記憶域 (RHB および RLB) は IRLM 私用記憶域内に含まれています。表示出力の解釈には、次の情報を使用してください。

PC IRLM 始動プロシージャーの PC オプションの現行値を表示します。DB2 バージョン 8 では、この値は常に YES です。

BB PVT (MEMLIMIT)2 GB 境界より下の現行の専用ストレージ量を表示します。この例では、PVT 値は 1738 MB です。



|

AB PVT (MEMLIMIT)境界より上の現行の専用ストレージ制限を表示します。MEMLIMIT

とも呼ばれ、MVS によって管理されます。このストレージは、ロックに使用されます。この例では、AB PVT 値は 2 GB です。

LTE 最後にこの IRLM がグループに接続されたときにカップリング・ファシリティーで使用可能であったロック表のエントリー数。それぞれの単位は、1 048 576 エントリーから構成されます。LTE が 1 単位未満の場合、値はゼロです。

LTEW ロック・テーブル・エントリー幅は、ロック構造内の各ロック・テーブル・エントリーに必要なバイト数です。グループ内ユーザー数が多くなると、各ロック・テーブル・エントリーを管理するために必要なバイト数が増えます。6 ユーザーまでの LTEW は 2、22 ユーザーまでの LTEW は 4、32 ユーザーまでの LTEW は 8 です。

RLE 最後にこの IRLM がグループに接続されたときにカップリング・ファシリティーで使用可能であったレコード・テーブル・エントリー数。

RLEUSE MODIFY コマンド発行時にカップリング・ファシリティーで使用中であった RLE の数。IRLM が CF から切断されている場合、この数の意味は、DISCONNECT 前に IRLM が最終更新した時点で使用中だった RLE です。

CSA USE CSA USE は DB2 バージョン 8 では使用されませんが、互換性の理由のみで表示されます。

CUR その時点での CSA および ECSA 使用量の合計を表示します。この場合、その時点での使用量 (CUR) は 312 KB であり、最高水準点(HWM) も 312 KB です。IRLM として使用した記憶域は、この合計記憶域の一部です。

ACCNT 報告書の ACCNT 行は、ロック制御ブロック構造とその記憶域使用状況の明細を示すものです。

T-1 タイプ 1 構造はリソースのためのものです。この場合、合計 2048 KB の 1 つの記憶域セグメントが保持されていることが示されています。

T-2 タイプ 2 構造は、特定のリソースに対する最初の要求後の、すべてのリソース要求のためのものです。この例では、合計 1024 KB の 1 つの記憶域セグメントが保持されていることが示されています。

T-3 タイプ 3 構造は、リソースを待っている、またはリソースを保持している、要求側または作業単位のためのものです。この例では、合計 4KB の 1 つの記憶域セグメントが保持されていることが示されています。

PROC および MISC 行これらのリスト行には、DBMS 要求の処理に使用される私用記憶域に関する使用情報を含まれています。この情報は、IBM ソフトウェア・サポートのガイドのもとで問題診断に使用してください。



詳しくは、「DB2 コード」のメッセージ DXR100I に関する説明を参照してください。


MODIFY PR21PROC,STATUS,TRACE

このコマンドは、次の出力をシステム・コンソールに表示します。

DXR179I PR21034 TRACE USAGETRACE BUFFER STORAGE IN USE: 256 KBMAXIMUM NUMBER OF TRACE BUFFERS ALLOWED PER TRACE TYPE: 10TRACE TYPE ACTIVE BUFFERS IN USE CTRACE WRITER---------- ------ -------------- -------------

SLM N 0 NXIT Y 2 NXCF N 0 NDBM N 0 NEXP Y 1 NINT Y 1 N

説明: この例は、IRLM トレースに現在割り振られている記憶域が 256 KB であること、トレース・タイプごとに許されるトレース・バッファーの最大数が 10 にセットされていること、外部 CTRACE 書き込み機能がアクティブでないこと、を示しています。トレース・タイプについて詳しくは、 461ページの『第 85 章TRACE CT (z/OS IRLM)』を参照してください。

トレースを活動化または非活動化するには、 461ページの『第 85 章 TRACE CT

(z/OS IRLM)』に示されている z/OS TRACE CT コマンドを使用します。EXP および INT トレースをオフにすることはできません。XIT (データ共用の場合)、EXP、および INT のトレースは、 IRLM 開始時に自動的にアクティブ化されます。IRLMPROC TRACE=YES により、すべてのトレースは自動的にアクティブ化されます。

各バッファーのトレース・サイズは 64KB です。トレース・バッファーの最大数を変更するには、307 ページの MODIFY irlmproc,SET,TRACE=nnn コマンドを使用してください。


MODIFY IR21I,STATUS,MAINT

このコマンドは、次の出力をシステム・コンソールに表示します。

DXR104I IR21240 MAINTENCE LEVELSLMOD.Csect MaintLv Date Csect APAR DATE

DXRRLM00.DXRRL010 PQ35083 02/22/00 DXRRL020 PQ35083 02/22/00DXRRL030 PQ27464 08/18/99 DXRRL040 PQ35083 02/22/00

説明: この出力は、IRLM ロード・モジュール CSECTS の保守レベルを 2 列フォーマットで示しています。



第 50 章 -MODIFY TRACE (DB2)

DB2 コマンド MODIFY TRACE は、次のことを行います。v 特定のアクティブ・トレースに対して、トレース中のトレース・イベント

(IFCID) を変更します。v 指定されたトレースで以前アクティブであった IFCID を停止します。v 統計レコードを書き込みます。

省略形: -MOD TRA


v 『環境』

v 『許可』








IFI/IFC プログラムによって開始したトレース: アクティブなトレースを変更する前に、IFI アプリケーション・プログラムまたは IFC Selective Dump ユーティリティー (DSN1SDMP) がトレースを開始していないようにしてください。DSN1SDMP によってスタートされたトレースを修正すると、DSN1SDMP ユーティリティーは異常終了します。DSN1SDMP が終了すると、トレースを停止します。この停止処理は、トレースの停止または再始動を実行する MODIFY TRACE コマンドの処理に支障をきたすことがあります。

許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v TRACE 特権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限



構文

�� MODIFY TRACE ( PERFM )ACCTGSTATAUDITMONITOR

�

*,

CLASS( integer ) TNO(integer) �

� �

*,

IFCID( ifcid_nbr )COMMENT(string)

��

オプションの説明TRACEどの IFCID を開始するかを決めます。表 26 は、各トレース・タイプ、その省略形、および各タイプの要旨をリストしています。各トレース・タイプについて詳しくは、 407ページの『第 73 章 -START TRACE (DB2)』を参照してください。

表 26. トレース・タイプ

タイプ省略形説明

PERFM P 特定のイベントのパフォーマンス・レコード

ACCTG A トランザクションごとのアカウンティング・レコード

STAT S 統計データ

AUDIT AU 監査データ

MONITOR MON モニター・データ

もう 1 つのトレース・タイプについては、ここでは説明していません。そのトレース・タイプは保守を目的としたもので、IBM ソフトウェア・サポートの指示のもとに使用するものです。詳しくは「DB2 Diagnosis Guide and Reference」を参照してください。

CLASS(integer, ...)リストを、指定のクラスについて開始された IFCID に限定します。

省略形: C

integer は、開始された IFCID のリストが限定されるクラスです。指定可能なクラスの説明については、 407ページの『第 73 章 -START TRACE (DB2)』を参照してください。

デフォルトは CLASS(*) です。これは、すべてのデフォルトの IFCID クラスを開始します。

-MODIFY TRACE (DB2)


TNO(integer)修正する特定のトレースを指定します。これはトレース番号 (1 ～ 32、01 ～09) によって識別されます。指定できるトレース番号は 1 つだけです。TNO はMODIFY TRACE コマンドの必須オプションとなっています。

TNO キーワードにはデフォルトがありません。

IFCID(ifcid_nbr, ...)CLASS オプションに指定されたクラスに含まれる IFCID に加えて、開始する他の IFCID (トレース・イベント) を指定します。IFCID オプションに指定された IFCID だけを開始するには、トレース・クラス 30 ～ 32 を使用してください。これらのクラスには事前定義された IFCID がないため、ロケーションはこれらのクラスを使用できます。(IFCID オプションに指定されたトレース・イベントだけをアクティブ化する例については、323 ページの『例』を参照してください。)

IFCID オプションを指定しないと、アクティブ化されたトレース・クラスに含まれる IFCID だけが開始されます。

IFCID の最大数は 156 です。また、IFCID オプションで有効な値の範囲は 1

～ 350 です。ただし、4、5、185、187、217、232、234、240、241 は例外です。

デフォルトは IFCID(*) です。

COMMENT(string)トレース出力レコード (常駐のトレース・テーブルを除く) に複製されるコメントを指定します。

string は任意の文字ストリングです。ブランク、コンマ、または特殊文字を含んでいる場合はアポストロフィで囲む必要があります。

例トレース番号 6 を変更して、統計データとアカウンティング・データのみを収集するようにします。CLASS(30) の定義は各自のサイトで行えます。

-MODIFY TRACE(S) IFCID(1,2,3) TNO(6) CLASS(30)COMMENT (’STATS AND ACCOUNTING ON’)

-MODIFY TRACE (DB2)

第 50 章 -MODIFY TRACE (DB2) 323

第 51 章 REBIND PACKAGE (DSN)

DSN サブコマンド REBIND PACKAGE は、パッケージに影響を与える変更を行うがプログラム中の SQL ステートメントは変更しない場合に、アプリケーション・パッケージを再バインドするのに使用します。例えば、許可を変更したりパッケージの索引を新たに作成したり RUNSTATS を使用するような場合に REBIND

PACKAGE を使用できます。REBIND PACKAGE(*) コマンドを出す場合、トリガー・パッケージには影響はありません。

REBIND PACKAGE は通常、BIND PACKAGE と比べて高速かつ経済的です。次の場合には、ACTION(REPLACE) オプションを指定した BIND PACKAGE を使用すべきです。

v SQL ステートメントを変更する場合

v プログラムを再コンパイルする場合

v 前に SQLERROR(CONTINUE) オプションを指定して BIND PACKAGE を実行した

REBIND PACKAGE の使用について詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。


v 『環境』

v 『許可』





環境REBIND PACKAGE は DB2I 経由で使用したり、フォアグラウンドやバックグラウンドで実行中の DSN セッションから REBIND PACKAGE サブコマンドを入力することができます。


許可パッケージ所有者には、REBIND PACKAGE の対象となるパッケージに組み込まれたすべての SQL ステートメントを実行するための許可が必要です。それがないと、パッケージの作成時にエラー・メッセージが出されます。VALIDATE(BIND) の場合、DB2 は許可をバインド時に検査します。VALIDATE(RUN) の場合、DB2 は最初は許可をバインド時に検査しますが、許可の検査が失敗するとそれを実行時に再検査します。


表 27 では、REBIND PACKAGE を実行するのに必要な許可を、指定したオプションに応じて説明しています。

表 27. REBIND PACKAGE に必要な特権の要約

オプション REBIND PACKAGE を実行するのに必要な許可

REBIND PACKAGE、所有権の変更なし(OWNER キーワードが指定されていないため)。

このプロセスの許可 ID には、次のいずれかの権限が必要です。v パッケージの所有権v パッケージに対する BIND 特権v パッケージの所有者からの BINDAGENT 特権v 該当するコレクション、またはすべてのコレクションに対する

PACKADM 権限v SYSADM または SYSCTRL 権限

REBIND PACKAGE、所有権の変更なし、ただし、OWNER キーワードに元の所有者が指定されている。

このプロセスの許可 ID には、次のいずれかの権限が必要です。v OWNER authorization-id は、バインダーの 1 次許可 ID または 2

次許可 ID のいずれかでなければなりません。v パッケージの所有者からの BINDAGENT 特権v SYSADM または SYSCTRL 権限

REBIND PACKAGE、所有権の変更あり。(元の所有者ではない許可ID が OWNER キーワードに指定されています。)

新しい OWNER には次のいずれかの権限が必要です。v パッケージに対する BIND 特権v 該当するコレクション、またはすべてのコレクションに対する

PACKADM 権限v SYSADM または SYSCTRL 権限

OWNER の指定: 所有者から認可された BINDAGENT 権限がいずれかの許可 ID にあれば、その認可者を authorization-id に OWNER

として指定できます。そうでない場合、 OWNER authorization-id はバインダーの 1 次または 2 次許可 ID のいずれか 1 つでなければなりません。

BIND PLAN を実行するために必要な許可については、「DB2 管理ガイド」第 5

部 (第 2 巻) を参照してください。



構文

�� REBIND PACKAGE �

� �

,

( . collection-id . package-id . )location-name * * ( )

version-id*

*

�

�OWNER(authorization-id) QUALIFIER(qualifier-name) CURRENTDATA( YES )

NO

�

�DBPROTOCOL( DRDA )

PRIVATEDEFER(PREPARE)NODEFER(PREPARE)

DEGREE( 1 )ANY

�


BINDDEFINEINVOKE


EXPLAIN( YES )NO

�

�I

FLAG( W )EC

IMMEDWRITE( NO )YES

ISOLATION( RR )RSCSURNC

NOKEEPDYNAMIC( YES )

�

�(1)

NONE(2)

REOPT( ALWAYS )ONCE

OPTHINT(’hint-id’)

�

,


�

�(3)

PATHDEFAULTRELEASE( COMMIT )

DEALLOCATEVALIDATE( RUN )

BIND

��

注:



3 PATHDEFAULT キーワードと PATH キーワードを同時に使用することはできません。この両方のキーワードを同じ REBIND コマンドに指定しないでください。


第 51 章 REBIND PACKAGE (DSN) 327

enable-block:

��

� �

�

�

�

�

�

,


DB2CALLCICS DLIBATCH( connection-name )IMS ,IMSBMPIMSMPP CICS( applid )REMOTE ,RRSAF

ENABLE(*) IMSBMP( imsid ),

IMSMPP( imsid ),

REMOTE( location-name )<luname>

��

オプションの説明構文図に示されているオプションの説明については、 69ページの『第 15 章 BIND

および REBIND オプション』を参照してください。

使用上の注意複数のパッケージを再バインドする場合、DB2 はそれぞれの正常な再バインドをコミットしてから次のパッケージを再バインドします。

例ローカル・ロケーション USIBMSTODB22 に存在する、パッケージTEST.DSN8BC81.(MAY_VERSION) および PRODUCTION.DSN8BC81.

(DEC_VERSION) を再バインドします。接続 ID が CON2 であれば、このパッケージは CICS または DLIBATCH 環境からのみ実行されます。この結果、BIND

PACKAGE コマンドで指定された CON1 は置き換えられます。

REBIND PACKAGE (USIBMSTODB22.TEST.DSN8BC81.(MAY_VERSION),USIBMSTODB22.PRODUCTION.DSN8BC81.(DEC_VERSION)) -

ENABLE (CICS,DLIBATCH) CICS (CON2)



第 52 章 REBIND PLAN (DSN)

DSN サブコマンド REBIND PLAN は、プランに影響を与える変更が行うがプログラム中の SQL ステートメントは変更しない場合に、アプリケーション・プランを再バインドするのに使用します。例えば、許可を変更したり、プランの索引を新たに作成したり、RUNSTATS を使用するような場合に REBIND PLAN を使用できます。再バインドが正常に行われると、アプリケーション・プランが作成され、カタログ表 SYSPLAN にあるその記述が更新されます。

REBIND PLAN は通常、BIND PLAN と比べて高速かつ経済的です。しかし、SQL

ステートメントを変更したりプログラムを再コンパイルする場合には、オプションACTION(REPLACE) を指定した BIND PLAN を使用してください。

REBIND PLAN の使用について詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。


v 『環境』

v 『許可』





環境REBIND PLAN は DB2I 経由で使用したり、フォアグラウンドやバックグラウンドで実行中の DSN セッションから REBIND PLAN サブコマンドを入力することができます。


許可REBIND PLAN がエラー・メッセージを出さずにプランを作成するには、プラン所有者がそのプランに組み込まれているすべての SQL ステートメントを実行する許可を有していることが必要です。VALIDATE(BIND) の場合、DB2 は許可をバインド時に検査します。VALIDATE(RUN) の場合、DB2 は最初は許可をバインド時に検査しますが、許可の検査が失敗するとそれを実行時に再検査します。PKLIST キーワードを使用する場合には、そのパッケージまたはコレクションの EXECUTE 権限を PKLIST に指定する必要があります。

330ページの表 28 では、REBIND PLAN を実行するのに必要な許可を、指定したオプションに応じて説明しています。


表 28. REBIND PLAN に必要な特権の要約

オプション REBIND PLAN を実行するのに必要な許可

REBIND PLAN、所有権の変更なし (OWNER キーワードが指定されていないため)。

このプロセスの許可 ID には、次のいずれかの権限が必要です。v プランの所有権v プランに対する BIND 特権v プランの所有者からの BINDAGENT 特権v SYSADM または SYSCTRL 権限

REBIND PLAN、所有権の変更なし。ただし、OWNER キーワードに元の所有者が指定されている。

このプロセスの許可 ID には、次のいずれかの権限が必要です。v OWNER authorization-id は、バインダーの 1 次許可 ID

または 2 次許可 ID のいずれかでなければなりません。v プランの所有者からの BINDAGENT 特権v SYSADM または SYSCTRL 権限

REBIND PLAN、所有権の変更あり。(元の所有者ではない許可 ID が OWNER キーワードに指定されています。)

新しい OWNER には次のいずれかの権限が必要です。v プランに対する BIND 特権v SYSADM または SYSCTRL 権限

OWNER の指定: 所有者から認可された BINDAGENT 権限がいずれかの許可 ID にあれば、その認可者をauthorization-id に OWNER として指定できます。そうでない場合、 OWNER authorization-id はバインダーの 1 次または2 次許可 ID のいずれか 1 つでなければなりません。

PKLIST、個々のパッケージを指定

処理の許可 ID には、以下のいずれかの権限が含まれている必要があります。v PKLIST に指定された各パッケージに対する EXECUTE 特権

v パッケージが入っている特定のコレクションに対する、またはコレクション * に対する PACKADM 権限

v SYSADM 権限

PKLIST、コレクション内のすべてのパッケージを示す (*)

を指定

処理の許可 ID には、以下のいずれかの権限が含まれている必要があります。v コレクション中の各パッケージに対する EXECUTE 特権v collection-id * に対する EXECUTE 特権v collection-id、または * に対する PACKADM 権限v SYSADM 権限

REBIND PLAN を実行するために必要な許可については、「DB2 管理ガイド」第 5


REBIND PLAN (DSN)


構文

�� REBIND PLAN �

,

( plan-name )* OWNER(authorization-id) QUALIFIER(qualifier-name)

enable-block pklist-block �

�NODEFER(PREPARE)DEFER(PREPARE)

ACQUIRE( USE )ALLOCATE

CACHESIZE(decimal-value) CURRENTDATA( NO )YES

�

�CURRENTSERVER(location-name) DBPROTOCOL( DRDA )

PRIVATEDEGREE( 1 )

ANYDISCONNECT( EXPLICIT )

AUTOMATICCONDITIONAL

�


BINDENCODING( ASCII )

EBCDICUNICODEccsid

EXPLAIN( NO )YES

IFLAG( W )

EC

�

�IMMEDWRITE( NO )

YESISOLATION( RR )

RSCSUR

NOKEEPDYNAMIC( YES )

NONE (1)REOPT( ALWAYS (2) )

ONCE

�

�OPTHINT(’hint-id’)

�

,


PATHDEFAULT (3) RELEASE( COMMIT )DEALLOCATE

�

�SQLRULES( DB2 )

STDVALIDATE( RUN )

BIND

��

注:

1. REOPT(VARS) は、REOPT(ALWAYS) の同義語として指定できます。

2. NOREOPT(VARS) は、REOPT(NONE) の同義語として指定できます。

3. PATHDEFAULT キーワードと PATH キーワードを同時に使用することはできません。この両方のキーワードを同じ REBIND コマンドに指定しないでください。

REBIND PLAN (DSN)

第 52 章 REBIND PLAN (DSN) 331

||

enable-block:

��

� �

�

�

�

�

,


DB2CALLCICS DLIBATCH( connection-name )IMS ,IMSBMPIMSMPP CICS( applid )RRSAF ,

ENABLE(*)IMSBMP( imsid )

,

IMSMPP( imsid )

��

pklist-block:

��

�

,

PKLIST( . collection-id . package-id )location-name * **

NOPKLIST

��

オプションの説明構文図に示されているオプションの説明については、 69ページの『第 15 章 BIND


使用上の注意複数のプランを再バインドする場合、DB2 はそれぞれの正常な再バインドをコミットしてから次のプランを再バインドします。

例プラン DSN8BC81 を再バインドして、新規に作成された索引を DB2 が利用できるようにします。FLAG(W) を使用すると、警告、エラー、完了の各メッセージは出して、通知メッセージは出さないようにします。VALIDATE(BIND) を使用すると、バインド処理中に生じたエラー条件を示すようにします。ISOLATION(CS) を使用すると、このアプリケーションが使用するデータベース値をそれが使用中にのみ他のアプリケーションが変更できないようにします。この分離レベルにより、変更された値はアプリケーションがコミットまたは終了するまで保護されます。OWNER キーワードを省略して、そのプランの所有者許可 ID を同じままにします。ENABLE または DISABLE キーワードを省略して、以前このプランに定義した接続を使用します。

REBIND PLAN (DSN)


REBIND PLAN (DSN8BC81) -FLAG (W) -VALIDATE (BIND) -ISOLATION (CS)

REBIND PLAN (DSN)

第 52 章 REBIND PLAN (DSN) 333

REBIND PLAN (DSN)


第 53 章 REBIND TRIGGER PACKAGE (DSN)

DSN サブコマンド REBIND TRIGGER PACKAGE は、 DB2 が CREATE

TRIGGER ステートメントを実行した時に作成されたパッケージを再バインドします。このサブコマンドを使用して、パッケージ作成時に DB2 が使用したデフォルトのバインド・オプションの、限定されたサブセットを変更することができます。また、新しい索引の作成後や RUNSTATS ユーティリティーの使用後に、 SQL ステートメントを再度最適化するため、トリガー・パッケージを再バインドする場合もあります。さらに、パッケージが依存している索引や別のオブジェクトが除去されたために、パッケージに無効のマークが付けられた場合、トリガー・パッケージを再バインドすることができます。

再バインドが正常終了すると、トリガー・パッケージに有効のマークが付けられます。REBIND TRIGGER PACKAGE(*) を出すと、再バインドは、このコマンドの発行者が再バインドを許可されているすべてのトリガー・パッケージに影響します。トリガー・パッケージはリモート側で再バインドすることはできません。ロケーション名は、REBIND TRIGGER PACKAGE サブコマンドにパッケージ名を指定する場合、使用できます。ただし、そのロケーション名はリモート・ロケーションを参照してはなりません。

REBIND TRIGGER PACKAGE の使用について詳しくは、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 5 部を参照してください。


v 『環境』

v 『許可』






環境DB2I から REBIND TRIGGER PACKAGE を使用するか、またはフォアグラウンドやバックグラウンドで実行中の DSN セッションから REBIND TRIGGER

PACKAGE サブコマンドを入力することができます。


許可パッケージ所有者には、REBIND PACKAGE の対象となるパッケージに組み込まれたすべての SQL ステートメントを実行するための許可が必要です。それがないと、パッケージの作成時にエラー・メッセージが出されます。


このサブコマンドを実行するには、次の特権または権限のいずれかを含む処理の特権セットを使用する必要があります。v トリガー・パッケージの所有権v トリガー・パッケージに対する BIND 特権v トリガー・パッケージの所有者からの BINDAGENT 特権v 該当するコレクション、またはすべてのコレクションに対する PACKADM 権限v SYSADM 権限v SYSCTRL 権限

トリガー・パッケージをバインドする場合、トリガー・アクション内のステートメントをバインドする権限の検査には、現行の許可 ID の特権が使用されます。REBIND TRIGGER PACKAGE には、次のいずれかの特権または権限が必要です。

v パッケージの所有権

v パッケージに対する BIND 特権

v 所有者から授与された BINDAGENT 特権

v PACKADM 権限

v SYSADM 権限

v SYSCTRL 権限

REBIND TRIGGER PACKAGE を実行するために必要な権限については、「DB2 管理ガイド」第 5 部 (第 2 巻) を参照してください。

構文

�� REBIND TRIGGER PACKAGE �

� ( collection-id . package-id )location-name. * *

�

�CURRENTDATA( YES )

NOEXPLAIN( YES )

NOI

FLAG( W )EC

�

�IMMEDWRITE( NO )

YESISOLATION( RR )

RSCSURNC

�

�RELEASE( COMMIT )

DEALLOCATE

��



オプションの説明TRIGGER PACKAGE再バインドするトリガー・パッケージ (1 つあるいは複数) を指定します。

以下のオプションは、パッケージのロケーション、コレクション、およびパッケージ名を識別します。ロケーションとコレクションを識別することができます。REBIND TRIGGER の場合は、トリガー・パッケージ名を指定しなければなりません。

location-name

現在のローカル・ロケーションを識別します。トリガー・パッケージのリモートでの再バインドはできません。location-name は DBMS のロケーションであり、このロケーションにパッケージは再バインドされ、そのパッケージ記述が存在します。

デフォルトは、ローカル DBMS です。

collection-id または *再バインドするトリガー・パッケージをすでに含んでいるスキーマ名を識別します。デフォルトはありません。

REBIND TRIGGER の場合、アスタリスク (*) を使用すれば自分がバインド特権を有するすべてのコレクションにおいて指定された package-id をもつすべてのローカル・パッケージを再バインドできます。

package-id または *カタログ表 SYSPACKAGE の列 NAME にリストされているとおりに、再バインドするトリガー・パッケージ名を指定します。デフォルトはありません。

パターン・マッチング文字 (*) を使用すれば、自分がバインド特権を有するcollection-id 内のすべてのローカル・トリガーを再バインドすることができます。

構文図に示されているオプションの説明については、 69ページの『第 15 章 BIND


REBIND TRIGGER PACKAGE コマンドにスキーマ名とトリガー・パッケージを指定する方法について詳しくは、「DB2 アプリケーション・プログラミングおよびSQL ガイド」第 4 部を参照してください。

使用上の注意トリガー・パッケージの制約事項: トリガー・パッケージは明示的に再バインドすることができますが、BIND PACKAGE サブコマンドを使用して明示的にバインドすることはできません。

トリガー・パッケージは、 FREE PACKAGE サブコマンドまたは DROP

PACKAGE ステートメントを使用して、明示的に解放することはできません。トリガー・パッケージを削除するには、DROP TRIGGER ステートメントを使用してください。


第 53 章 REBIND TRIGGER PACKAGE (DSN) 337

トリガー・パッケージはコピーできず、ローカルでのみ再バインドできます。トリガー・パッケージのリモートでの再バインドはできません。

複数のトリガー・パッケージの再バインド: 複数のトリガー・パッケージを再バインドする場合、DB2 はそれぞれの正常な再バインドをコミットしてから、次のパッケージを再バインドします。

出力REBIND TRIGGER PACKAGE は、SYSPACKAGE カタログ表の COLLID とNAME の列を更新します。

例次のコマンドを入力して、パッケージの ADMF001 コレクション内のトリガー・パッケージ TRIG1 を再バインドします。

REBIND TRIGGER PACKAGE (ADMF001.TRIG1);


DSNT254I - DSNTBRB2 REBIND OPTIONS FORPACKAGE = STLEC1.ADMF001.TRIG1.()ACTIONOWNER ADMF001QUALIFIER ADMF001VALIDATE BINDEXPLAIN NOISOLATION CSRELEASE COMMITCOPY

DSNT255I - DSNTBRB2 REBIND OPTIONS FORPACKAGE = STLEC1.ADMF001.TRIG1.()SQLERROR NOPACKAGECURRENTDATA YESDEGREE 1DYNAMICRULES BINDNODEFER PREPAREREOPT NONEKEEPDYNAMIC NODBPROTOCOL DRDAQUERYOPT 1PATH

"SYSIBM","SYSFUN","SYSPROC","SYSADM","ADMF001"DSNT232I - SUCCESSFUL REBIND FOR

PACKAGE = STLEC1.ADMF001.TRIG1.()



第 54 章 -RECOVER BSDS (DB2)

DB2 コマンド RECOVER BSDS は、二重ブートストラップ・データ・セット(BSDS) がデータ・セット・エラーによって使用不可になった後、それを再確立するときに使用します。二重 BSDS モードを再確立するには、次のステップに従ってください。

1. DB2 システムが割り振り解除した、障害のある BSDS をアクセス方式サービスを使用して名前変更または削除し、障害のある BSDS と同じ名前を指定して新しい BSDS を定義してください。制御ステートメントはジョブ DSNTIJIN にあります。

2. DB2 コマンド RECOVER BSDS を出して、残りの BSDS のコピーを新たに割り振られたデータ・セットに作成し、二重 BSDS モードを再確立してください。

省略形: -REC BSDS


v 『環境』

v 『許可』








許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v BSDS 特権v SYSCTRL 権限v SYSADM 権限



構文

�� RECOVER BSDS ��

使用上の注意BSDS 入出力エラー後の RECOVER BSDS: BSDS 入出力エラー発生後に二重BSDS モードを再確立するために実行する必要があるステップの詳細については、「DB2 管理ガイド」第 4 部 (第 1 巻) を参照してください。

例二重 BSDS モードを再確立します。

-RECOVER BSDS

-RECOVER BSDS (DB2)


第 55 章 -RECOVER INDOUBT (DB2)

DB2 コマンド RECOVER INDOUBT は、DB2 またはトランザクション管理プログラムがコミット・コーディネーターによって未確定状態を自動的に解決できなかったために、未確定のままになっているスレッドをリカバリーするときに使用します。

このコマンドの使用は、自動的な解決が作動しない場合に限る必要があります。コミット・コーディネーターは、コミットまたは打ち切り決定を決定する必要があります。

省略形: -REC IND


v 『環境』

v 『許可』









許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v RECOVER 特権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限



構文

�� RECOVER INDOUBT(connection-name)

ACTION( COMMIT )ABORT

�

� �

�

�

,

ID( correlation-id )*,

NID( network-id ),

LUWID( luwid )token

��

オプションの説明(connection-name)

1 ～ 8 文字の接続名を指定します。関連スレッド (分散されたスレッドを含む)

がリカバリーされます。このパラメーターは、LUWID が指定されると無視されます。

デフォルトは、このコマンドを入力する接続名です。このコマンドを z/OS コンソールから入力し、ID または NID パラメーターを使用して関連スレッドをリカバリーしている場合は、接続名を指定する必要があります。デフォルトの接続名は使用できません。

ACTION未確定スレッドをコミットするか、取り消すかを指定します。ローカル・スレッドがコーディネーターとなっているダウンストリーム参加プログラムがある場合は、コミットまたは打ち切りの判断がそれらの参加プログラムに伝搬されます。

省略形: ACT

(COMMIT)スレッドをコミットします。

(ABORT)スレッドを取り消します。

ID(correlation-id, ...)接続名に関連した、特定の関連スレッドまたはすべての関連スレッド (分散されたスレッドを含む) をリカバリーするかどうかを指定します。

correlation-id

リカバリーする特定のスレッドの相関 ID (1 ～ 12 文字) です。複数の相関 ID を使用する場合は、ID をコンマで区切ります。

-RECOVER INDOUBT (DB2)


複数のネットワーク ID が関連している相関 ID は使用しないでください。その場合は、NID を使用してください。

(*) 接続名に関連したすべての未確定スレッドをリカバリーします。同じ相関ID を持つスレッドでも解決します。

NID(network-id, ...)スレッドをそのネットワーク ID に基づいてリカバリーします。

network-id は、個々のスレッドに関連したネットワーク ID です。同じ接続名で複数のネットワーク ID を使用できます。

IMS および CICS 接続の場合、ネットワーク ID は net-node.number として指定されます。これは 3 ～ 25 文字の長さです。

v net-node は、作業単位の起点となったシステムのネットワーク・ノード名です。 net-node は 1 ～ 8 文字の長さです。

v number は、起点のシステム内の固有の番号です。number は 1 ～ 16 文字の長さです。

RRSAF 接続の場合、ネットワーク ID は、作業単位を固有に識別するために使用する z/OS RRS リカバリー単位 ID (URID) になります。z/OS RRS URID は32 文字の番号です。

ネットワーク ID は、作業単位の 16 バイトの固有識別番号として、コミット・コーディネーターのリカバリー・ログ上に現れます。

v IMS および CICS の場合、ネットワーク ID は、8 バイトのノード名の直後に 8 バイトの数値が付いたものになります。

v RRSAF 接続の場合、ネットワーク ID は 16 バイトの数値です。

LUWID指定された LUWID を持つ未確定スレッドをリカバリーします。

luwid

LU ネットワーク名、LUW インスタンス番号、およびコミット・シーケンス番号から構成されます。

LU ネットワーク名は、1 ～ 8 文字のネットワーク ID、ピリオド、および1 ～ 8 文字のネットワーク LU 名で構成されます。LUW インスタンス番号は、ピリオドと、その後の 12 文字の 16 進数値で構成されます。LUWID の最後のエレメントは 4 文字の 16 進数のコミット・シーケンス番号で、その前にピリオドが付きます。

token

トークンは、LUWID を表現するための別の方法です。DB2 は、作成した各スレッドにトークンを割り当てます。トークンは 1 ～ 6 桁の 10 進数で、LUWID を表示するすべての DB2 メッセージで等号の後ろに表示されます。

1 ～ 6 桁の 10 進数を入力すると、DB2 はトークンが指定されたものと見なします。DB2 が特定の LUWID に割り当てたトークンはその DB2 サブシステムでは固有のものですが、必ずしもすべてのサブシステムで固有であるとは限りません。


第 55 章 -RECOVER INDOUBT (DB2) 343

使用上の注意ネットワーク ID を使用する場合: correlation-id で未確定スレッドを識別できるため、network-id は通常は不要です。ただし、この correlation-id が固有でない場合はnetwork-id を使用する必要があります。LUWID を指定すると、network-id は不要です。

コマンドで指定されたスレッドがグローバル・トランザクションの一部である場合、コマンドはグローバル・トランザクション内のすべてのスレッドに対して実行されます。グローバル・トランザクションの説明については、「DB2 管理ガイド」を参照してください。

例例 1: 未確定の関連スレッドをリカバリーします。コマンドの入力が行われる接続名に関連した、すべてのスレッドのコミットをスケジューリングします。

-RECOVER INDOUBT ACTION(COMMIT) ID(*)

例 2: リモート・リクエスターから未確定スレッドをリカバリーします。トークンが 1332 である未確定スレッドのコミットをスケジューリングします。

-RECOVER INDOUBT ACTION(COMMIT) LUWID(1332)

例 3: リモート・リクエスターから未確定スレッドをリカバリーします。2 つの未確定スレッドの打ち切りをスケジューリングします。1 番目のスレッドは LUWID

= DB2NET.LUNSITE0.A11A7D7B2057.0002 です。(LUWID の最後のセグメントにある 0002 は、コミット・シーケンス番号を表しています。) 2 番目のスレッドはトークン 442 を持っています。

-RECOVER INDOUBT ACTION(ABORT)LUWID (DB2NET.LUNSITE0.A11A7D7B2057.0002, 442)



第 56 章 -RECOVER POSTPONED (DB2)

DB2 コマンド RECOVER POSTPONED は、前の再始動中に未完了のままで残されたリカバリー単位のバックアウト処理を完了させます (POSTPONED ABORT リカバリー単位)。このコマンドは、自動解決を選択しないときに使用します。

Abbreviation: -REC POST


v 『環境』

v 『許可』

v 『構文』






COMMANDS)、または IMS か CICS の端末から発行することができます。




構文

�� RECOVER POSTPONEDCANCEL

��


オプションの説明CANCEL延期された異常終了リカバリー単位すべてを DB2 が処理することを即時に停止するよう指定します。延期された異常終了リカバリー単位を取り消すことにより、オブジェクトは不整合状態のままとなります。

この延期されたリカバリー単位が変更するオブジェクトは、リカバリー (バックアウト) されます。バックアウト処理が失敗した場合、そのオブジェクトはREFRESH PENDING (REFP) とマークされます。また、データベース例外表では RECOVER PENDING (RECP) または REBUILD PENDING (RBDP またはPSRBD) とマークされます。このオブジェクトの REFP 状況を解決するには、RECOVER ユーティリティーを実行してオブジェクトを以前の時点の状況にリカバリーするか、または LOAD REPLACE をそのオブジェクトに対して実行します。

使用上の注意リカバリー処理: すべての POSTPONED ABORT リカバリー単位に対して、常に、リカバリー (ロールバック) 処置が取られます。

出力RECOVER POSTPONED からの出力は、通知メッセージのみで構成されます。

RECOVER POSTPONED の処理: メッセージ DSNI024I に、ページ・セットまたはパーティションに対するバックアウト作業の完了および、ページ・セットまたはパーティションを再始動ペンディング状況から除去したことが示されます。

バックアウト処理が長時間続く場合は、バックアウト処理が完了するまで、定期的な間隔で進行中メッセージ DSNR047I が表示されます。

DB2 は、RECOVER POSTPONED コマンドが正常終了したらメッセージ DSN9022I

を出し、コマンドが正常終了しなかった場合はメッセージ DSN9023I を出します。メッセージ DSNV434I は、延期された異常終了リカバリー単位を解決不要な場合にRECOVER POSTPONED が出されたことを示します。

例延期された異常終了リカバリー単位をリカバリーするには、次のコマンドを入力します。

-RECOVER POSTPONED

延期された異常終了リカバリー単位が見つかると、次のような出力が作成されます。

DSNV435I - RESOLUTION OF POSTPONED ABORT URS HAS BEEN SCHEDULEDDSNI024I - DSNIARPL BACKOUT PROCESSING HAS COMPLETED

FOR PAGESET DBKD0103.IPKD013A PART 00000004.DSNI024I - DSNIARPL BACKOUT PROCESSING HAS COMPLETED

FOR PAGESET DBKD0103.TPKD0103 PART 00000004.DSNI024I - DSNIARPL BACKOUT PROCESSING HAS COMPLETED

FOR PAGESET DBKD0103.IXKD013C PART (n/a).

-RECOVER POSTPONED (DB2)


|

|

DSNI024I - DSNIARPL BACKOUT PROCESSING HAS COMPLETEDFOR PAGESET DBKD0103.IUKD013B PART (n/a).

DSNI024I - DSNIARPL BACKOUT PROCESSING HAS COMPLETEDFOR PAGESET DBKD0103.IPKD013A PART 00000002.

DSNI024I - DSNIARPL BACKOUT PROCESSING HAS COMPLETEDFOR PAGESET DBKD0103.TPKD0103 PART 00000002.

DSNI024I - DSNIARPL BACKOUT PROCESSING HAS COMPLETEDFOR PAGESET DBKD0101.IXKD011C PART (n/a).

DSNI024I - DSNIARPL BACKOUT PROCESSING HAS COMPLETEDFOR PAGESET DBKD0101.IXKD011B PART (n/a).

DSNI024I - DSNIARPL BACKOUT PROCESSING HAS COMPLETEDFOR PAGESET DBKD0101.IUKD011A PART (n/a).

DSNI024I - DSNIARPL BACKOUT PROCESSING HAS COMPLETEDFOR PAGESET DBKD0101.TLKD0101 PART (n/a).

DSN9022I - DSNVRP ’RECOVER POSTPONED’ NORMAL COMPLETION

延期されたリカバリー単位が見つからないと、次のような出力が出されます。

DSNV434I - DSNVRP NO POSTPONED ABORT THREADS FOUNDDSN9022I - DSNVRP ’RECOVER POSTPONED’ NORMAL COMPLETION


第 56 章 -RECOVER POSTPONED (DB2) 347

第 57 章 -RESET GENERICLU (DB2)

RESET GENERICLU コマンドを使用すれば、VTAM によって特定の DB2 サブシステムの 1 つ以上のパートナーのカップリング・ファシリティーに格納された情報を除去することができます。このコマンドは、その情報を除去しようとする特定パートナー LU に対して VTAM 類縁性をもつ DB2 サブシステムから出す必要があります。

省略形: -RESET GENERIC


v 『環境』

v 『許可』










構文

�� RESET GENERICLU �

,

( luname )netid.luname

(*)

��

オプションの説明(luname)総称 LU 名のマッピングが除去されるパートナーの実際の VTAM LU 名を指定します。このパートナー LU の NETID は、ローカル DB2 NETID と同じであることが必要です。

(netid.luname)指定された NETID と LUNAME に関連付けられた VTAM 共用メモリー情報が除去されることを指定します。

(*) この DB2 サブシステムのすべてのパートナーに関する VTAM 共用メモリー情報を除去します。このコマンド・オプションは、該当する DB2 サブシステムをDB2 グループから削除しようとしている場合にのみ使用してください。

使用上の注意RESET GENERICLU コマンドが正常に実行されるには、以下の条件を満たしている必要があります。

v DDF が開始されていなければなりません。

v コマンドに指定したパートナー LU に対してアクティブ状態の VTAM セッションがあってはなりません。

v DB2 には、指定されたパートナー LU に関連した未確定スレッドの解決情報があってはなりません。

例例 1: パートナー NET1.USER5LU に関連した VTAM 総称名のマッピングを除去します。

-DB2A RESET GENERICLU(NET1.USER5LU)

例 2: この DB2 サブシステムのパートナーである LU すべての VTAM 総称名のマッピングを除去します。このバージョンのコマンドを使用するのは、この DB2

サブシステムをデータ共用グループから削除する場合だけです。

-DB2A RESET GENERICLU(*)

-RESET GENERICLU (DB2)


第 58 章 -RESET INDOUBT (DB2)

DB2 コマンド RESET INDOUBT は、DISPLAY THREAD コマンドが生成した未確定スレッド報告書に表示された情報を除去します。

このコマンドは、次の状態の未確定スレッド情報を除去する場合には必ず使用します。

v 参加プログラムのコールド・スタート、同期点プロトコル・エラー、あるいは未確定解決プロトコル・エラーのため、DB2 がコーディネーターの役割を果たせないスレッドの場合。

v 未確定であったが、RECOVER INDOUBT コマンドによって解決されたスレッドで、その後のコーディネーターとの再同期でヒューリスティック・ダメージを見せているスレッドの場合。

未確定スレッドの表示スレッド報告書の RESET 欄で、このコマンドによって報告書の情報を除くべきかどうかが示されます。

このコマンドは、以下の場合のスレッドの未確定スレッド情報を除去するときにも使用できます。

v DB2 は、参加プログラムによる自動解決を妨げるエラーが検出されない場合でもコーディネーターの役割を果たします。この情報を除去するには、FORCE キーワードを指定しなければなりません。影響を受ける参加プログラムとの再同期は行われません。

v DB2 は、コーディネーターによる自動解決を妨げるエラーが検出されない場合でも、参加プログラムの役割を果たします。コーディネーターとの再同期は行われません。

省略形: -RESET IND


v 『環境』











構文

�� RESET INDOUBT �

�

�

�

,

LUNAME( luname )* FORCE

,

LOCATION( location-name ),

IPADDR( nnn.nnn.nnn.nnn:port )* FORCE

,

LUWID( luwid )token LOCATION(location-name)

��

オプションの説明LUNAME(luname, ...)指定された LUNAME に関するすべての修飾未確定情報を除去します。

luname

1 ～ 8 文字の名前で表します。複数の LUNAME を使用する場合は、それぞれの名前をコンマで区切ります。

(*) すべての SNA ロケーションについて、未確定情報を除去します。

FORCE自動解決を妨げるエラーが検出されない場合でも、コーディネーターおよび参加プログラムの未確定解決の役割を強制的に除きます。FORCE は、IPADDR または LUNAME と共に使用することができます。

自動再同期を妨げるエラーが検出されていないときに再同期情報を除去すると、コールド・スタートをシミュレートします。したがって、このコマンド実行時は、名前を指定されたパートナーと DB2 間の接続は存在しません。FORCE オプションの実行後は、指名されたパートナー・ロケーションとの次の接続がコー

-RESET INDOUBT (DB2)


ルド・スタート接続になります。このコマンド実行時に名前を指定されたパートナーとの接続が存在する場合は、コマンドは失敗し、メッセージ DSNL448I が出されます。

FORCE を使用するとリカバリー・ログ名の交換でエラーが起きた結果パートナーが接続の試みを拒否した場合に、ウォーム・スタート接続問題を回避できます。

LOCATION(location-name, ...)指定された location に関するすべての修飾未確定情報を除去します。

location-name は 1 ～ 16 文字の名前として指定し、この名前は、リクエスターかサーバーかに関係なく、パートナーを識別します。パートナーが DB2 UDB

for z/OS サブシステムでない場合は、ロケーション名は次のいずれかのフォーマットで指定できます。

v サーバー・ロケーションで VTAM に定義されている 1 ～ 8 文字の LU

名。この名前をより小 (<) およびより大 (>) 文字で囲み、DB2 ロケーション名と区別する必要があります。

v ドット 10 進数表記の TCP/IP アドレス。

IPADDR(nnn.nnn.nnn.nnn:port)ドット 10 進数表記 IP アドレス (再同期ポート番号と関連付けられたアドレス) に関係するすべての対象となっている未確定情報を除去します。

このキーワードは、パートナーが SNA の代わりに TCP/IP を使用しているとき、 LUNAME キーワードの代わりに使用することができます。

nnn.nnn.nnn.nnn:port

リモート・サイトのドット 10 進 IP アドレスの後ろに、再同期ポート番号を続けたものです。複数の IP アドレスとポートを使用する場合は、コンマを使用してリスト内で項目を区切ります。

(*) すべての TCP/IP ロケーションについて、未確定情報を除去します。

LUWID指定の LUWID によってスレッドの未確定情報を除きます。

luwid

LU ネットワーク名、LUW インスタンス番号、およびコミット・シーケンス番号から構成されます。

LU ネットワーク名は 1 ～ 8 文字のネットワーク ID、ピリオド、そして1 ～ 8 文字のネットワーク LU 名の順で構成されます。LUW インスタンス番号は、ピリオドと、その後の 12 文字の 16 進数値で構成されます。この LUWID の最後の要素はコミット・シーケンス番号で、ピリオドとその後に続く 4 桁の 16 進文字からなります。

token

トークンは、LUWID を表現するための別の方法です。DB2 は、作成した各スレッドにトークンを割り当てます。トークンは 1 ～ 6 桁の 10 進数で、LUWID を表示するすべての DB2 メッセージの中で、等号の後ろに表示されます。


第 58 章 -RESET INDOUBT (DB2) 353

1 ～ 6 桁の 10 進数を入力すると、DB2 はトークンが指定されたものと見なします。DB2 が特定の LUWID に割り当てたトークンはその DB2 サブシステムでは固有のものですが、必ずしもすべてのサブシステムで固有であるとは限りません。

出力このコマンドからの応答には、DSNL440I ～ DSNL449I のいずれかのメッセージが含まれています。

RESET INDOUBT の指定が正しくないと、メッセージ DSNL440I が出されます。

使用上の注意参加プログラムの未確定情報の除去: FORCE オプションを使用して参加プログラムの未確定情報を除去する場合は、注意が必要です。通常、RECOVER INDOUBT コマンドを使用した後には、ヒューリスティック・ダメージが生じたかどうかをコーディネーターの自動解決が判別します。コーディネーターによる自動解決がアーカイブできるようになる前に RESET INDOUBT を使用すると、この検出結果が失われることになります。

コーディネーターの未確定情報の除去: 自動解決を妨げるエラーがないのに FORCE

オプションを使用してコーディネーターの未確定情報を除去する場合は、注意が必要です。情報が除去されると、未確定の参加プログラムはいずれもヒューリスティック判定処理を使用して、未確定の作業論理単位を解決するよう強制されます。



第 59 章 RUN (DSN)

DSN サブコマンド RUN は、アプリケーション・プログラムを実行します。このプログラムには、SQL ステートメントを組み込むことができます。


v 『環境』

v 『許可』

v 『構文』




環境このサブコマンドは、フォアグラウンドまたはバックグラウンドのいずれかのモードで実行する DSN コマンド処理プログラムから出すか、または DB2I RUN パネルを使用して出すことができます。


許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v プランでの EXECUTE 特権v プランの所有権v SYSADM 権限

アプリケーションを実行するには、ローカル・サーバーでプランが使用可能になっていなければなりません。また、ステートメントを実行した関連パッケージも使用可能にする必要があります。

構文

�� RUN PROGRAM(program-name)PLAN(plan-name)

CP PLAN(plan-name)

�

�LIBRARY(library-name) PARMS(parameter-string)

��


オプションの説明次の 2 つの文節のうち少なくとも 1 つは使用しますが、同じ文節を 2 回使用しないでください。

PROGRAM (program-name)実行したいプログラムを識別します。

CP入力をユーザーのコマンド処理プログラムに渡して、プロンプトが ENTER TSO

COMMAND を出すようにします。このオプションは、コマンド処理プログラムの実行やプログラムのデバッグ (例えば、COBTEST など) を行うときに役立ちます。

指定された TSO コマンドを処理すると、TSO コマンドが実行される新しいタスク制御構造が作成されます。この TSO コマンド・セッションから開始するアプリケーション・プログラムも、すべて同じタスク構造下で実行し、SQL 要求を用いる場合は新しい DB2 への接続を確立しなければなりません。

TSO コマンドが完了するとその新しいタスク構造は終了し、制御は元の DB2

接続、および DSN コマンドによって確立されたタスク構造に戻されます。

TSO コマンドは後で DSN セッションから直接、あるいは CP オプションを指定した RUN サブコマンドを介して出すことができます。

PLAN(plan-name)この指定は、PROGRAM オプションの後にある場合はオプションですが、CP

オプションの後にある場合は必須です。

plan-name は、プログラムのアプリケーション・プランの名前です。

PROGRAM を使用する場合、デフォルト・プラン名は program-name です。

LIBRARY(library-name)実行するプログラムが入ったデータ・セット名を指定します。

library-name を指定しないと、通常の z/OS ライブラリー検索が使用されます。プログラムのエントリー・ポイント名が最初に検索されるのは、STEPLIB DD

ステートメントに指定されたデータ・セットです。STEPLIB が存在しなければ、JOBLIB DD ステートメントに指定されたデータ・セットが検索されます。エントリー・ポイント名がそこになければ、今度はリンク・リストが検索されます。

サブプログラム: 通常の z/OS ライブラリー検索は、常に、主プログラムがロードしたサブプログラムに対して使用されます。サブプログラムがその主プログラムと同じライブラリーに常駐しているのであれば、library-name もその通常のz/OS 検索パターン (STEPLIB、JOBLIB、リンク・リスト) に定義する必要があります。この方法で定義されたライブラリーに、主プログラムとすべてのロードされるサブプログラムの両方が入っていれば、LIBRARY オプションを使用する必要はありません。

PARMS(parameter-string)parameter-string は、アプリケーション・プログラムに渡すパラメーター・リストです。リスト内の各項目はコンマまたはブランク、あるいはその両方で区切り、そのリストはアポストロフィで囲んでください。このリスト内にアポストロ

RUN (DSN)


フィが含まれる場合には、その各アポストロフィを 2 つの連続したアポストロフィで表してください。リストは、1 ～ 100 の 10 進数文字の可変長文字ストリングとして渡されます。

アセンブラーの場合: 'プログラム・パラメーター' の形式のリストを使用してください。ランタイム・パラメーターはありません。

アプリケーション・プログラムへ渡される parameter-string の RUN サブコマンドによって、ランタイムまたはアプリケーション・パラメーターの妥当性検査は行われません。指定されたすべてのパラメーターは、アプリケーション・プログラムが書かれた言語で定義されているパラメーター構文と形式の基準に従っているものと見なされます。

C の場合: A/B の形式のリストを使用してください。この A はランタイム・オプションのリストを示し、B は C アプリケーション・プログラムのパラメーターのリストを示しています。ランタイム・オプションが必要ではない場合、/B

の形式でリストを作成してください。NOEXECOPS ランタイム・オプションが有効である場合は、「/」を省略してください。

COBOL の場合: 言語処理環境がランタイム環境ではない場合、B/A の形式のリストを使用してください。この B は COBOL アプリケーション・プログラムのパラメーターのリストを表し、A はランタイム・オプションのリストを示しています。プログラム・パラメーターが必要でなければ、そのリストを /A の形式で作成してください。

言語処理環境がランタイム環境であれば、A/B の形式のリストを使用してください。この A はランタイム・オプションのリストを示し、B は COBOL アプリケーション・プログラムのパラメーターのリストを示しています。ランタイム・オプションが必要ではない場合、/B の形式でリストを作成してください。互換性のために、言語処理環境では、CBLOPTS ランタイム・オプションを提供しています。CEEDOPT または CEEUOPT で CBLOPT(YES) が指定されていて、メインルーチンが COBOL であれば、このリストを B/A の形式 (ランタイム環境が言語処理環境でないときの形式と同じ) で指定します。CBLOPT(NO)

はデフォルトです。

FORTRAN の場合: A/B の形式のリストを使用してください。この A はFORTRAN ランタイム・オプションのリストを表し、B は FORTRAN アプリケーション・プログラムのパラメーターのリストを示しています。FORTRAN ランタイム・オプションが必要ない場合、B または /B の形式でリストを作成してください。プログラム引数のなかにスラッシュが存在する場合は、2 番目の形式を使用する必要があります。FORTRAN ランタイム・オプションのみが存在する場合は、リストは A/ の形式で作成してください。

PL/I の場合: A/B の形式のリストを使用してください。この A はランタイム・オプションのリストを示し、B は PL/I アプリケーション・プログラムのパラメーターのリストを示しています。ランタイム・オプションが必要でない場合、/B の形式でリストを作成してください。PL/I NOEXECOPS プロシージャー・オプションが指定されている場合は、「/」を省略してください。通知システム・メッセージは、スラッシュを省略した場合や、PL/I ランタイム・パッケージに渡した値が無効な場合に出されます。

RUN (DSN)

第 59 章 RUN (DSN) 357

使用上の注意マルチタスキングの制限: マルチタスク環境を使用するプログラムを実行する場合、SQL ステートメントを発行する最初のタスクがその後のすべての SQL 呼び出しを行わなければなりません。つまり、マルチタスキング環境においては 1 つのタスクだけが SQL 呼び出しを出すことができます。このタスクは DSN 主プログラムのサブタスクであるか、あるいはその主プログラムと同じ TCB レベルで実行するタスクでなければなりません。

例例 1: アプリケーション・プログラム DSN8BC4 を実行します。アプリケーション・プランの名前は同じです。プログラムは、ライブラリー 'prefix.RUNLIB.LOAD'

内にあります。

DSN SYSTEM (DSN)RUN PROGRAM (DSN8BC4) LIB (’prefix.RUNLIB.LOAD’)

例 2: アプリケーション・プログラム DSN8BP4 を実行します。アプリケーション・プランは DSN8BE81 です。プログラムは、ライブラリー'prefix.RUNLIB.LOAD' 内にあります。パラメーター O’TOOLE を、PL/I ランタイム・オプションを指定せずに PL/I アプリケーション・プログラムに渡します。

DSN SYSTEM (DSN)RUN PROGRAM (DSN8BP4) PLAN (DSN8BE81) -

LIB (’prefix.RUNLIB.LOAD’) PARMS (’/O’TOOLE’)

RUN (DSN)


第 60 章 -SET ARCHIVE (DB2)

DB2 コマンド SET ARCHIVE は、アーカイブ・ログ用テープ装置の最大数を設定します。また、このコマンドは、アーカイブ・ログ用テープ装置の最大割り振り解除時間も設定します。このコマンドは、インストール時、または以前の SET

ARCHIVE コマンドの呼び出し時に指定された値をオーバーライドします。SET

ARCHIVE による変更は一時的なものであり、再始動の際には DB2 はインストール時に設定した値を再度使用します。

省略形: -SET ARC


v 『環境』

v 『許可』








許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v ARCHIVE 特権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限



構文

�� SET ARCHIVE �

�COUNT (integer) TIME( minutes )

,seconds,seconds1440NOLIMIT

DEFAULT

��

オプションの説明以下のオプションは、インストール時に指定された READ TAPE UNITS(COUNT)

および DEALLC PERIOD TIME サブシステム・パラメーターをオーバーライドします。

COUNT(integer)読み取りアーカイブ・ログ専用にできるテープ装置の最大数を指定します。この値は、複数テープ上に存在する複数の固有なアーカイブ・データ・セットに許された並行読み取り数に影響を与えます。

integer の範囲は 1 ～ 99 です。v 指定した数が現行の指定より大きい場合は、読み取りアーカイブ・ログに許されたテープ装置の最大数が増加します。

v 指定した数が現行の指定より小さい場合は、使用されていないテープ装置はすぐに割り振り解除され、新しい COUNT 値に調整されます。アクティブの(または事前取り付けの) テープ装置は、割り振られたままです。非アクティブのテープ装置のみが、COUNT 値の減少による割り振り解除対象になります。

TIME割り振られたアーカイブ読み取りテープ装置が、割り振り解除になる前に未使用のままでいられる時間の長さを指定します。

(minutes)最大分数を指定します。

minutes は、0 ～ 1439 の整数でなければなりません。

(seconds)最大秒数を指定します。

seconds は、1 ～ 59 の整数でなければなりません。

(NOLIMIT) または (1440)テープ装置が絶対に割り振り解除されないことを示します。TIME(1440) を指定することは、TIME(NOLIMIT) と同等です。TIME を 1440 で指定すると、秒数指定は行えません。

-SET ARCHIVE (DB2)


DEFAULTCOUNT および TIME パラメーターをリセットし、DB2 インストール時に指定された値に戻します。

使用上の注意アーカイブ・テープ読み取りのパフォーマンス: アーカイブ・テープの読み取りで最高のパフォーマンスを達成するには、指定可能な最大値 (システム制限内での) をCOUNT と TIME 両方のオプションに指定します。

IEF238D「REPLY DEVICE NAME OR CANCEL」メッセージ: このメッセージに「CANCEL」と応答すると、COUNT 値がテープ装置の現行数にリセットされます。例えば、現行の COUNT 値が 10 ですが、7 番目のテープ装置への要求に対し「CANCEL」と応答すると、COUNT 値は 6 にリセットされます。

データ共用環境におけるテープ割り振り解除の遅延: データ共用グループのメンバー上でリカバリー・ジョブを実行依頼して、そのジョブが必要とする磁気テープ装置は一定時間未使用の状態でないと割り振り解除できない場合、グループのどの他メンバーも、そのテープが割り振り解除されるまで、アーカイブ・テープを使用することはできません。すべてのリカバリー・ジョブを同じメンバーから実行依頼するのでない限り、COUNT オプションを使用してインストール・パネル DSNTIPA

にあるフィールド DEALLOC PERIOD の値が 0 であることを確認する必要はありません。

出力このコマンドからの応答には、DSNJ334I ～ DSNJ337I のいずれかのメッセージが含まれています。

例例 1: 磁気テープ装置を 2 台割り振ります。これらのテープ装置は未使用状態が30 秒経過した後、割り振り解除することができます。

-SET ARCHIVE COUNT(2) TIME(,30)

例 2: 磁気テープ装置を 4 台割り振ります。これらのテープ装置は未使用状態が 2

分経過した後、割り振り解除することができます。

-SET ARCHIVE COUNT(4) TIME(2)

例 3: 磁気テープ装置を 1 台割り振ります。このテープ装置は、割り振り解除されません。

-SET ARCHIVE COUNT(1) TIME(1440)

-SET ARCHIVE (DB2)

第 60 章 -SET ARCHIVE (DB2) 361

第 61 章 -SET LOG (DB2)

DB2 コマンド SET LOG は、インストール時に指定されたチェックポイント頻度を変更します。このコマンドは、直前の SET LOG コマンドの呼び出しで指定された値もオーバーライドします。SET LOG による変更は一時的なものであり、再始動の際には DB2 は再びインストール時に設定した値を使用するようになります。LOGLOAD 値は、次のシステム・チェックポイントの後で有効になります。SET

LOG は、現行 DB2 サブシステムのロギングおよび更新アクティビティーをSUSPEND または RESUME するのにも使用できます。


v 『環境』

v 『許可』







許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v ARCHIVE 特権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限



構文

�� SET LOG LOGLOAD(integer)CHKTIME(integer)SUSPENDRESUME

��

オプションの説明次のオプションは、インストール・パネル「DSNTIPN」の「CHECKPOINT FREQ」フィールドに指定された LOGLOAD サブシステム・パラメーターをオーバーライドします。

LOGLOAD(integer)次のチェックポイントか開始するまでの間に DB2 が書き込むログ・レコードの数を指定します。0 の値を指定すれば、現行の LOGLOAD 値を変更せずに、システム・チェックポイントを開始することができます。

integer は 0、または 200 から 16000000 までの範囲内です。

CHKTIME(integer)連続したチェックポイント間の開始間隔を分単位で指定します。このオプションは、インストール・オプションまたはチェックポイント頻度に基づくLOGLOAD オプションにより指定されたログ・レコードをオーバーライドします。

integer には、0 ～ 60 の任意の整数値を指定できます。0 を指定すると、システム・チェックポイントが即時開始され、チェックポイント頻度は変更されません。

SUSPEND現行の DB2 サブシステムに対するロギングおよび更新アクティビティーを、SET LOG RESUME が発行されるまで中断するよう指定します。DB2 では、書き込みしていないログ・バッファーを外部化し、システム・チェックポイントを取り (非データ共用環境の場合)、BSDS を高記述 RBA で更新し、その後、更新アクティビティーを中断します。メッセージ DSNJ372I が発行され、更新アクティビティーが再開するまでコンソールに表示されます。

SUSPEND は、32 KB ページの書き込みおよびすべてのページ・サイズに対するデータ・セット拡張を静止します。ご使用のデータのボリューム・レベル・コピーを行っている時点で、32 KB ページ書き込みが進行中であれば、SUSPEND

は、データのコピーをリストアする時点で 32 KB ページの矛盾したコピーが行われないようにします。データ・セット拡張が進行中であれば、データのコピーをリストア時点で、SUSPEND は、VSAM カタログと DB2 データ間で矛盾が発生しないようにします。

このオプションは、ARCHIVE LOG または STOP DB2 のいずれかのコマンドがシステム静止をアクティブ化するときは、使用できません。更新アクティビティーは、SET LOG RESUME または STOP DB2 が発行されるまで中断されま

SET LOG (DB2)


|

|

|

|

|

|

|

す。(また、ロギングを中断する場合、必ず、CANCEL OFFLOAD 指定でARCHIVE LOG コマンドを発行してください。)

推奨事項: 高活動の時間帯に、または長時間にわたり、ログ・アクティビティーを中断したままにしないでください。更新アクティビティーの中断は、ロック・タイムアウトや DB2 および IRLM 診断ダンプなどのタイミング関連のイベントを引き起こす可能性があります。

RESUME現行の DB2 サブシステムに対するロギングおよび更新アクティビティーを再開し、コンソールからメッセージ DSNJ372I を除去するよう指定します。32 KB

ページ書き込みとすべてのサイズのページに対するデータ・セット拡張を再開します。

推奨事項: コマンド許可検査中に競合発生の可能性を回避するために、このコマンドを z/OS コンソールまたはインストール SYSADM ID から発行します。ロギングが SET LOG SUSPEND コマンドによって中断されると、ログ書き込みラッチのペンディングによって発生する競合が原因となって、ロギングが再開するまでコマンド許可検査がハングする可能性があります。

使用上の注意LOGLOAD および CHKTIME 値が DB2 パフォーマンスに与える影響: LOGLOAD

および CHKTIME 値は、異常終了後に DB2 を再始動するために要する時間に影響する可能性があります。いずれのオプションも、大きい値にすると再始動時にかかる時間が長くなります。低い値にすると、DB2 が過度にチェックポイントを取ることになります。しかし、LOGLOAD(0) または CHKTIME(0) を指定すると、チェックポイント要求は、バッチ・ジョブから発行した場合は同期となり、z/OS またはTSO コンソールから発行した場合は非同期となります。

現行の LOGLOAD 設定を表示するには、DISPLAY LOG コマンドを使用します。

LOGLOAD または CHKTIME に指定する値は、DB2 再始動時にリセットされ、サブシステム・パラメーターで指定された値になります。コマンド SET SYSPARM

を発行して別の値をロードする場合は、その新しい値が使用されます。

ロギングを中断する時点: SET LOG SUSPEND を指定するのは、システム・レベルのポイント・イン・タイム・リカバリーまたは災害時リカバリーのためのデータベースおよびログ全体のリモート・コピーを作成する前です。ピアツーピアのリモート・リカバリー (PPRC) および FlashCopy® を使用して、リモート・コピーを作成できます。ロギングを中断してデータベースのリモート・コピーを作成することにより、更新アクティビティーの静止を回避できます。ロギングが中断されている間、読み取り専用アクティビティーは継続します。

SET LOG SUSPEND および SET LOG RESUME ウィンドウ間で行われるバックアップには、コミットされていないデータが含まれる場合があります。DB2 サブシステム全体をログが中断された時点に復元する必要がある場合、バックアップからデータベース全体とログを復元し、その後、DB2 を再始動して DB2 サブシステム全体を整合した状態にリカバリーします。詳細については、「DB2 管理ガイド」第 4


SET LOG (DB2)

第 61 章 -SET LOG (DB2) 365

|

|

|

例例 1: 現行の LOGLOAD 値を変更せずに、システム・チェックポイントを開始します。

-SET LOG LOGLOAD(0)

例 2: システム・チェックポイント間隔を、 150000 ログ・レコードごとにするように変更します。

-SET LOG LOGLOAD(150000)

例 3: ログ・アクティビティーを中断します。

-SET LOG SUSPEND

例 4: ログ・アクティビティーを再開します。

-SET LOG RESUME

SET LOG (DB2)


第 62 章 -SET SYSPARM (DB2)

DB2 コマンドの SET SYSPARM により、DB2 の稼動中にサブシステム・パラメーターを変更することができます。


v 『環境』

v 『許可』

v 『構文』






許可このコマンドを実行するには、次の権限のいずれかを含む処理の特権セットを使用する必要があります。

v SYSOPR 権限

v SYSCTRL 権限

v SYSADM 権限


構文

�� SET SYSPARM LOAD( DSNZPARM )load-module-name

RELOADSTARTUP

��


オプションの説明LOAD(load-module-name)記憶域へロードするロード・モジュールの名前を指定します。デフォルトのロード・モジュールは DSNZPARM です。

RELOAD最後に名前を指定したサブシステム・パラメーターのロード・モジュールを記憶域へ再ロードします。

STARTUPロードしたパラメーターを始動時の値にリセットします。

使用上の注意サブシステムのサブシステム・パラメーターを更新するには、次のステップに従ってください。

1. 更新モードでインストール手順を一通り実行します。

2. 新しいサブシステム・パラメーターのロード・モジュールを作成します。

3. SET SYSPARM コマンドを発行します。

インストール SYSADM (SYSADM1 および SYSADM2) サブシステム・パラメーターを変更するには、インストール SYSADM 権限を含む許可を使用する必要があります。また、インストール SYSOPR (SYSOPR1 および SYSOPR2) サブシステム・パラメーターも変更するには、インストール SYSADM 権限を含む許可を使用する必要があります。

インストール SYSADM またはインストール SYSOPR サブシステム・パラメーターを変更しようとして、そのための適切な権限がない場合は、新規モジュールの無許可値が使用されるのではなく、新規のサブシステム・パラメーター・モジュールをロードする前に使用していたパラメーター値が使用されます。 DB2 は、サブシステム・パラメーターに対する無許可変更が行われるたびに、メッセージ DSNZ015

を出します。

例例 1: DSNZPARM から ADMPARM1 に変更します。

-SET SYSPARM LOAD(ADMPARM1)

例 2: ADMPARM1 が現在実行中のロード・モジュールであれば、それを再ロードします。

-SET SYSPARM RELOAD

例 3: DB2 サブシステムが始動時にロードしたサブシステム・パラメーターを再ロードします。

-SET SYSPARM STARTUP

-SET SYSPARM (DB2)


第 63 章 SPUFI (DSN)

DSN サブコマンド SPUFI は、ファイル入力を使用する SQL 処理プログラムを実行します。


v 『環境』

v 『許可』

v 『構文』


環境このサブコマンドは ISPF 下でのみ使用可能です。ISPF オプション 6 から、または CLIST から出すことができます。



構文

�� SPUFI ��

使用上の注意SPUFI セッション: SPUFI サブコマンドは SPUFI を実行し、SPUFI セッションの開始時に SPUFI パネルを表示します。SPUFI の使用に関するパネルと手順については、「DB2 アプリケーション・プログラミングおよび SQL ガイド」第 1 部を参照してください。

SPUFI セッションでは、CURRENT SPUFI DEFAULTS パネルにアクセスできます。DB2I のデフォルトを変更するには、この画面を分割して DB2I DEFAULTS パネルにアクセスするか、あるいは SPUFI セッションの開始前にそのデフォルトを変更します。

SPUFI パネルの変数: DSN コマンドを使用して直接 SPUFI を呼び出した後に入力する SPUFI パネル変数は、同じ場所には保管されません。したがって、パネル変数は、機能を直接実行したか、または DB2I を介して実行したかにより異なります。


第 64 章 /SSR (IMS)

IMS /SSR コマンドを使用することにより、IMS オペレーターは外部サブシステム・コマンドを入力することができます。


v 『環境』

v 『許可』

v 『構文』






管理の手引き: システム」に記載があります。

さらに、1 次許可 ID またはいずれかの 2 次許可 ID が保持する特権セットには、/SSR の後に指定する DB2 コマンドを入力する権限が含まれていなければなりません。DB2 コマンドを発行するために必要な特権については、本書の該当するDB2 コマンドの説明を参照してください。

構文

�� /SSR subsystem-command ��

オプションの説明subsystem-command

有効なサブシステム・コマンドを指定します。/SSR に続く最初の文字は、このコマンドが渡されるサブシステム (この場合は、DB2) のサブシステム認識文字でなければなりません。サブシステム認識文字は、外部サブシステムの IMS

SSM メンバーに定義されています。


|

|

使用上の注意コマンドの経路指定: IMS では、コマンド認識文字 (CRC) を使用して、どの外部サブシステム (この場合は DB2) がコマンドを受け取るかを判断します。IMS が行うのは、該当するサブシステムにそのコマンドを経路指定することだけです。

/SSR (IMS)


第 65 章 /START (IMS)

IMS /START コマンド (SUBSYS パラメーター指定) は、IMS と指定の外部サブシステム間の接続を使用可能にします。接続が確立されると、アプリケーション・プログラムは外部サブシステムが管理するリソースにアクセスすることができます。

以下は、/START コマンドの一部の説明に過ぎません。詳しくは、「IMS コマンド解説書」を参照してください。


v 『環境』

v 『許可』

v 『構文』







構文

��

�

/START,

SUBSYS subsystem-nameSUBSYS ALL

��

オプションの説明SUBSYS

IMS に接続する 1 つ以上の外部サブシステムの名前またはすべての外部サブシステムを指定します。

subsystem-name, ...IMS に接続する外部サブシステムの名前を 1 つ以上指定します。


ALLすべての外部サブシステムを IMS に接続することを示します。

使用上の注意非アクティブ項目: 外部サブシステムの PROCLIB 項目の主記憶装置内のコピーは、その項目がアクティブではないとき (つまり、接続が存在しないとき) に/START コマンド機能の一部としてリフレッシュされます。この結果、インストール先では、 IMS を止めずに、サブシステム接続を停止し、PROCLIB 項目の指定を変更してから、サブシステム接続を再始動させることができます。

/START (IMS)


第 66 章 -START DATABASE (DB2)

START DATABASE コマンドを用いると、指定のデータベースが使用可能になります。どのオプションを指定したかに応じて、以下のオブジェクトが、読み取り専用処理、読み書き処理、またはユーティリティー専用処理に対して使用可能になります。

v データベース

v 表スペース

v 索引スペース

v パーティション表スペースまたは索引スペース (データ・パーティション 2 次索引を格納する索引スペースも含む) の物理パーティション

v 非パーティション 2 次索引の論理パーティション

このコマンドは、通常、以下のいずれかのイベントが発生した後で使用されます。

v STOP DATABASE コマンドが発行された

v 表スペース、パーティション、または索引がグループ・バッファー・プールRECOVER ペンディング状況 (GRECP) になった

v ページが、表スペース、パーティション、または索引に対する論理ページ・リスト (LPL) に入れられた

データ共用環境、このコマンドは、指定されたデータベースにアクセスできるグループのどの DB2 サブシステムからも出すことができます。

省略形: -STA DB


v 『環境』











|

|

|

|

|

|

|

許可このコマンドを実行するには、次の権限のいずれかを含む処理の特権セットを使用する必要があります。v STARTDB 特権v DBMAINT 権限v DBCTRL 権限v DBADM 権限v SYSCTRL 権限v SYSADM 権限

指定されたデータベースに対して STARTDB 特権が入っていない特権セットを使用すると、DB2 はエラー・メッセージを出します。

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


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

START DATABASE コマンドの使用許可を検査するには、データベース DSNDB01

の表スペース DBD01 と、データベース DSNDB06 の表スペースと索引スペースが必要な場合があります。この許可検査に必要な表スペースまたは索引スペースが停止している場合、あるいは使用できない場合、データベース、表スペース、または索引スペース (許可検査に必要なデータベース、表スペース、または索引スペースも含む) を開始するには、インストール SYSADM 権限が必要です。表スペースまたは索引スペースが LPL 状況または GRECP 状況にある場合、インストールSYSOPR は START DATABASE を使用してその表スペースまたは索引スペースをリカバリーできますが、アクセス・モードの変更は許可されない場合があります。

-START DATABASE (DB2)


#

#

#

#

#

#

#

#

#

構文

�� START DATABASE �

,


�

�

�

�

,

SPACENAM( space-name )* ,spacename1:spacename2spacename* PART( integer )*spacename integer1:integer2*spacename**spacestring1*spacestring2*

�

�RW

ACCESS( RO )UTFORCE

��

オプションの説明(database-name, ...)データベースの名前、または開始する表スペースまたは索引スペースに対するデータベースの名前を指定します。名前が複数ある場合は、リスト内の名前をコンマで区切ります。

(*) このプロセスの特権セットには少なくとも DBMAINT 権限またはSTARTDB 特権がある、すべてのデータベースを開始します (すでに開始されているデータベースを除く)。(*) は ACCESS(FORCE) と同時には指定できません。

DSNDB01、DSNDB06、および作業ファイル・データベース (DSNDB07 など) を開始できるのは、それらを明示的に指定した場合に限られます (例えば、START DATABASE(DSNDB01))。

dbname と dbstring は、以下のリストで任意の形式を取ることができます (ここで、dbname1 と dbname2 は、1 ～ 8 文字の任意の文字ストリングを表し、dbname は 1 ～ 7 文字の任意の文字ストリングを表します)。


第 66 章 -START DATABASE (DB2) 377

形式開始するデータベース

dbname1:dbname2 データベースの名前が dbname1 以上で、かつdbname2 以下のすべてのデータベース





SPACENAM開始するデータベース内の特定の表スペースまたは索引を指定します。ACCESS(FORCE) を使用する場合、表スペースと索引の名前のリストを指定した SPACENAM を使用することが必要です。


(space-name, ...)開始する表スペースまたは索引スペースの名前を指定します。表スペースと索引スペースのいくつかの名前のリストを使用できます。リスト内の名前はコンマで区切ります。

以下のものを指定する場合には、space-name を database-name の場合と同様に指定することができます。v 単一の表スペースまたは索引スペースの名前v 名前の範囲v 部分的な名前 (開始部分または終了部分のパターン・マッチング文字 (*)

を含む)

v パターン・マッチング文字 (*) で区切られた 2 つのストリングv このリスト内の前の項目を任意に組み合わせたもの。ただし、以下の例外があります。連続するパターン・マッチング文字 (*) は使用できません。また、2 つのパターン・マッチング文字 (*) をキーワード・ストリングの中に指定することはできません。

ACCESS(FORCE) オプションで、部分的な名前または名前の範囲を使用することはできません。

(*) 指定されたデータベース内の、すべての表スペースおよび索引スペースを開始します。(*) は ACCESS(FORCE) と同時には指定できません。

spacename と spacestring は、以下のリストで任意の形式を取ることができます (ここで、spacename1 と spacename2 は、1 ～ 8 文字の任意の文字ストリングを表し、spacename は 1 ～ 7 文字の任意の文字ストリングを表します)。



形式状況が表示される表スペースまたは索引スペース

spacename1:spacename2 名前が spacename1 以上で、かつspacename2 以下であるすべての表スペースまたは索引スペース




*spacestring1*spacestring2* 名前にストリング spacestring1 とspacestring2 を含むすべての表スペースまたは索引スペース

PART (integer, ...)指定された表スペースまたは索引内で開始する 1 つ以上のパーティションのパーティション番号を指定します。他のパーティションの START またはSTOP 状態は変更されません。

指定する integer は、対応するスペース名およびデータベース名の有効なパーティション番号でなければなりません。無効なパーティション番号を指定すると無効な番号ごとにエラー・メッセージが出されますが、指定されたその他の有効なパーティションはすべて開始されます。

以下のいずれかのように指定して、integer をコーディングできます。

v 1 つ以上のパーティションのリスト

v integer1 以上で integer2 以下のすべてのパーティション番号の範囲


PART オプションは、パーティション表スペース、パーティション化索引、およびパーティション表スペースの非パーティション・タイプ 2 索引について有効です。非パーティション表スペースまたは非パーティション表スペースに対する索引を PART に指定するとエラー・メッセージが出され、その非パーティション・スペースは開始されません。

ACCESS開始するオブジェクトが読み取り/書き込み、読み取り専用、またはユーティリティー専用のいずれの状況であるかを指定します。また、使用不可状況のオブジェクトに強制的にアクセスします。

省略形: ACC

(RW)指定されたデータベース、表スペース、索引、またはパーティションに対し、プログラムが読み書きを行えるようにします。

(RO)プログラムが、指定されたデータベース、表スペース、索引、またはパーティションからの読み取りのみを行えるようにします。プログラムが、指定されたオブジェクトへの書き込みを実行しようとしても成功しません。このオ



|

プションを宣言済み一時表のデータベース (AS TEMP オプションで作成されたデータベース) に使用しないでください。

(UT)指定されたデータベース、表スペース、索引、またはパーティションに対し、DB2 オンライン・ユーティリティーと SQL DROP ステートメントのみがアクセスできるようにします。

(FORCE)論理ページ・リスト内のページ、ペンディング中の据え置き再始動、書き込みエラー範囲、読み取り専用アクセス、またはユーティリティー制御が原因で、表スペース、索引、または区画が使用できないことを示す標識をリセットします。FORCE は、CHECK ペンディング、COPY ペンディング、および RECOVER ペンディング状態もリセットします。データへの全アクセス権限が強制されます。FORCE は、再始動ペンディング (RESTP) 状態のリセットには使用できません。

ACCESS(FORCE) 使用時は、単一のデータベース名、SPACENAM オプション、および表スペースと索引の名前の明示的なリストを使用しなければなりません。 DATABASE (*) または SPACENAM (*) を含め、いかなる範囲または組み合わせのパターン・マッチング文字 (*) も使用することはできません。

ユーティリティー限定状態は、ターゲット・オブジェクトがこのコマンドによってリセットされた場合にのみリセットされます (かつ、ユーティリティーが終了します)。どのオブジェクトがユーティリティーのターゲット・オブジェクトであるかを識別するには、DISPLAY DATABASE コマンドを使用するか、DISPLAY SYSUTIL オプション指定の DIAGNOSE ユーティリティーを実行します。DIAGNOSE ユーティリティーは、IBM ソフトウェア・サポートの指示のもとに使用してください。

注: 強制を行おうとしているオブジェクトが、前のリリースの DB2 で稼働しているユーティリティーによって、ユーティリティー読み取り専用(UTRO)、ユーティリティー読み取り/間見込み (UTRW)、またはユーティリティー・ユーティリティー (UTRO) 状態にされている場合、ACCESS(FORCE) は正常に完了しません。この状態が発生すると、DB2 はメッセージ DSNI041I を出します。限定状態をリセットするには、ユーティリティーを開始したリリースの DB2 を使用してそのユーティリティーを終了する必要があります。

ACCESS(FORCE) を使用して開始された表スペースまたは索引スペースは、矛盾した状態になっている可能性があります。詳しい手順については、『使用上の注意』を参照してください。

使用上の注意オフラインのデータ・セット: パーティション、表スペース、または索引を含むディスク・パックは、必ずしも、データベースの始動時にオンラインである必要はありません。ただし、パーティション、表スペース、または索引が最初に参照される場合には、パックをオンラインにしておかなければなりません。オンラインになっていないと、オープン時にエラーが生じます。



明示的に停止された表スペースと索引: 表スペースと索引を明示的に停止した(SPACENAM オプションを指定して STOP DATABASE コマンドを使用する) 場合、この表スペースと索引は明示的に開始する必要があります。データベースを開始しても、明示的に停止された表スペースまたは索引は開始しません。

GRECP または LPL 項目でマークされたオブジェクトへの影響: 表スペース、パーティション、または索引がグループ・バッファー・プール RECOVER ペンディング(GRECP) 状況である場合、あるいは表スペース、パーティション、または索引のページが論理ページ・リスト (LPL) に含まれている場合、START DATABASE コマンドによりオブジェクトのリカバリーが開始されます。 SPACENAM オプションと、ACCESS (RW) または (RO) を指定する必要があります。

このリカバリー操作は、すでに開始しているオブジェクトが SPACENAM に指定されていても実行されます。

コマンドを出した時点でオブジェクトが停止していると、START DATABASE コマンドはそのオブジェクトを開始すると同時に、GRECP または LPL 状況を消去します。GRECP または LPL のリカバリー処置が完了できなくでも、そのオブジェクトは開始されます。

コマンド権限の検査に必要な表スペースまたは索引スペースが使用不可の場合は、START DATABASE を出すためにインストール SYSADM 権限またはインストールSYSOPR 権限が必要になります。詳しくは、 376ページの『許可』を参照してください。

GRECP または LPL 状況にあるオブジェクトをリカバリーするにあたっては、データベース名とスペース名の両方とも、パターン・マッチング文字 (*) の使用を避けてください。複数の START DATABASE(dbname) SPACENAM(*) コマンドを並行して実行させると、START DATABASE(*) SPACENAM(*) コマンドを 1 つだけ実行するよりも早く処理が完了します。

データベース名とスペース名の両方でパターン・マッチング文字 (*) を使用する場合は、DBMAINT 権限が必要であり、さらに、カタログ・データベースとディレクトリー・データベースがすでに以下の順序で明示的に開始されていることを確認する必要があります。

-START DATABASE(DSNDB01) SPACENAM(*)

-START DATABASE(DSNDB06) SPACENAM(*)

推奨はできませんが、オブジェクトを開始するのに START DATABASE

ACCESS(FORCE) を使用することも可能です。これは、すべての LPL と書き込みエラー・ページ範囲項目をそのページをリカバリーせずに削除するものです。さらに、GRECP 状況も消去します。

LOG NO として、および GRECP の中で、または LPL の中にページを持つかのいずれかで定義された LOB 表スペースを開始するときに、LPL リカバリーに必要なログ・レコードが、LOG NO 属性のために失われていることを DB2 が検出すると、LOB 表スペースは AUXW 状態に置かれ、LOB は無効にされます。

ACCESS(FORCE) の使用: ACCESS(FORCE) オプションは、エラーが発生した後に、DSN1COPY または DB2 UDB for z/OS 以外のプログラムによって、データを前のレベルに復元するために使用することを意図したものであり、そのエラーのた



めに発生した例外状態がまだ存在していてリセットできない場合に使用するためのものです。ACCESS(FORCE) を使用する場合、DB2 に関しては、データの整合性を確認するのはユーザーの責任です。DSN1COPY については、「DB2 ユーティリティー・ガイドおよび解説書」を参照してください。

アプリケーション処理が表スペースに対するトランザクション・ロックを要求し、その表スペースが制約的な状況 (RECP) にあるか、必要な索引が制約的な状況にある場合、DB2 はそのロックを獲得します。リソースが使用可能ではないことを示すエラー・メッセージ (SQLCODE -904) をアプリケーションが受け取ると、DB2 はアプリケーションがその表スペースまたは索引にアクセスしようとするまで状況を検出しません。このメッセージを受け取った後、アプリケーションはロックをコミットまたはロールバックすることにより (RELEASE オプションの値が COMMIT

の場合)、あるいはそれを終了することにより (RELEASE オプションの値がDEALLOCATE の場合) 解放します。コマンド START DATABASE

ACCESS(FORCE) を表スペースまたは索引スペースのいずれかに出した時点でロックが有効であれば、そのコマンドは失敗します。

あるオブジェクトがロックを保存しているなら (つまり、DB2 データ共用グループのメンバーが失敗して、そのオブジェクトに対して保持していたロックがロック構造に保存された)、START DATABASE ACCESS (FORCE) は使用できません。

START DATABASE ACCESS(FORCE) は、延期された異常終了、または未確定のリカバリー単位が存在する場合は、実行されません。この状態の時に START

DATABASE ACCESS(FORCE) コマンドを出そうとすると、コマンドは失敗します。FORCE は、再始動ペンディング (RESTP) 状態のリセットには使用できません。RESTP 状態のリセットについては、「DB2 ユーティリティー・ガイドおよび解説書」第 2 部を参照してください。

制限付きモード (RO または UT): 制限付きモード (RO および UT) の START

DATABASE コマンドが有効になる時期は、アプリケーションが開始されたのがSTART DATABASE コマンド完了後であるかどうか、またはアプリケーションがこのコマンドが発行された時点で実行中であったかどうかにより異なります。START

DATABASE の完了後に開始されたアプリケーションの場合は、アクセス制限は即時に有効になります。START DATABASE が出された時点で実行中のアプリケーションの場合、アプリケーションが完了まで実行することを許可された時点でこのアクセス制限が有効になります。アプリケーションが START DATABASE コマンドによって割り込まれるかどうかは、さまざまな要因によって決まります。これらの要因には、START DATABASE コマンドに指定された ACCESS モード、表スペースまたはパーティション上のドレーン活動のタイプ (存在する場合)、および表スペースまたは、パーティション上に保持されたカーソルがあるか、などがあります。

定義済みの一時表用の表スペースや索引スペースを、RO または UT アクセスを使用して開始しないでください。UT アクセスを使用して一時ファイル・データベースを開始し、REPAIR DBD ユーティリティーを適応させることができます。

表スペース、索引、またはパーティションへのアクセスを、現在有効な ACCESS タイプと互換性のないモードで行わなければならない場合、DB2 ではリソース使用不可メッセージを発行します。



#

#

#

#

#

#

#

#

#

#

#

#

通信データベースまたはリソース限定機能: 通信データベース (CDB) またはリソース限定機能 (RLF) をデータ共用グループ内のいずれかのメンバーが現在使用中の場合、ACCESS(UT) を使用してアクティブのデータベースまたは表スペースを開始しようとしても失敗します。

同期処理の完了: メッセージ DSN9022I は、同期処理が正常に完了したことを示します。

非同期処理の完了: GRECP 状況のオブジェクト、または LPL にページが含まれるオブジェクトのリカバリーは、非同期的に実行されます。メッセージ DSNI022I が定期的に出され、リカバリーの進行状況を報告します。データベース、表スペース、または索引の開始 (同期タスク) は、リカバリー操作が開始する前に完了することがよくあります。そのため、同期処理が完了したことを示すメッセージDSN9022I を DB2 が出した時点でもオブジェクトのリカバリーが完了していないことがあります。TYPE および NAME で指定されたオブジェクト (表スペースまたは索引スペース) がグループ・バッファー・プール RECOVER ペンディング(GRECP) 状況または論理ページ・リスト (LPL) 状況になっているときにリカバリーが起動された場合は、START DATABASE への応答としてメッセージ DSNI006I

が発行されます。START DATABASE コマンドは、リカバリーの非同期タスクが完了するまでは完了しません。

メッセージ DSNI021I は、オブジェクトに対する非同期処理が完了したことを示すものです。コマンド DISPLAY DATABASE を出すことにより、オブジェクトすべてのリカバリー操作が完了しているかを判別できます。リカバリー操作が完了していれば、コマンドからの出力には LPL または GRECP のない、RW または RO 状況のいずれかが示されます。

LOB 表スペースの開始: START DATABASE コマンドは、LOB 表スペースおよび補助表の索引を開始するために使用できます。LOB 表スペースは、この LOB 表スペースが関連付けられている基本表から独立して開始されます。

例例 1: データベース DSN8D81A 内の表スペース DSN8S81E を開始します。表スペースが GRECP 状況にある場合にはそのスペースをリカバリーします。あるいは、LPL にページが存在している場合にはそのページをリカバリーします。

-START DATABASE (DSN8D81A) SPACENAM (DSN8S81E)

例 2: 自分が権限を持つすべてのデータベース (DSNDB01、DSNDB06、および作業ファイル・データベースを除く) を開始させます。状況が GRECP または LPL であるオブジェクトのリカバリーは実行されません。

-START DATABASE (*)

例 3: データベース DSN8D81A 内の表スペース DSN8S81E の 3 番目および 4 番目のパーティションを読み取り専用アクセス用に開始します。パーティションがGRECP 状況にある場合にはそのパーティションをリカバリーさせ、また LPL にページが存在する場合にはそのページをリカバリーさせます。

-START DATABASE (DSN8D81A) SPACENAM (DSN8S81E) PART (3,4) ACCESS (RO)



例 4: データベース DBIQUA01 内の、 ″T″ で始まり、ストリング ″IQUA03″ で終わるすべての表スペースを、読み取りおよび書き込みアクセスとして開始します。

-START DATABASE (DBIQUA01) SPACENAM (T*IQUA03) ACCESS (RW)


DSN9022I - DSNTDDIS ’START DATABASE’ NORMAL COMPLETION



第 67 章 -START DB2 (DB2)

DB2 コマンド START DB2 は、DB2 サブシステムを初期化します。操作が完了すると DB2 サブシステムはアクティブになり、TSO アプリケーションや他のサブシステム (IMS や CICS など) が利用できるようになっています。

システムを再始動した場合の結果は、DSNJU003 (ログ目録変更) ユーティリティーを使用して作成される条件付き再始動制御レコードによって制御することができます。これらの影響について詳しくは、 387ページの『使用上の注意』、および「DB2 ユーティリティー・ガイドおよび解説書」の DSNJU003 ユーティリティーの説明を参照してください。

省略形: -STA DB2


v 『環境』

v 『許可』





環境このコマンドは、z/OS コンソールからのみ発行できます。DB2 サブシステムの名前は、コマンド接頭部によって判別されます。例えば -START は、開始する DB2

サブシステムが '-' をコマンド接頭部としてもつサブシステムであることを示します。

DB2 サブシステムがすでにアクティブになっていれば、このコマンドはリジェクトされます。DB2 リソースの再始動リカバリー状況は、以前の DB2 シャットダウン状況から判別されます。


許可不要です。ただし、このコマンドは、START コマンドを出すことが可能な z/OS コンソールからのみ実行できます。「z/OS MVS システム・コマンド」を参照してください。


構文

�� START DB2DSNZPARM

PARM( module name )*

ACCESS( )MAINT

�

�NO

LIGHT( )YES

MSTR(jcl-substitution)�

�DBM1(jcl-substitution) DIST(jcl-substitution)

��

オプションの説明以下のいずれのオプションも必須ではありません。

PARM(module-name)DB2 サブシステム・パラメーターをもつロード・モジュールを指定します。

module-name は、インストール先提供ロード・モジュールの名前です。

デフォルトは DSNZPARM です。

ACCESSDB2 へのアクセスが全般的であるか制限付きであるかを指定します。

省略形: ACC

(*) アクセスを汎用にします。許可を受けたユーザーはすべて DB2 に接続できます。

デフォルトは ACCESS(*) です。

(MAINT)インストール SYSADM およびインストール SYSOPR 以外の許可 ID すべてに対するアクセスを禁止します。

データ共用については、ACCESS(MAINT) はこのコマンドを実行した DB2

メンバーについてだけアクセスを制限します。データ共用グループの他のメンバーは影響を受けません。

DB2 を ACCESS(MAINT) 指定で開始した場合、ストアード・プロシージャーおよびユーザー定義関数を実行することはできません。

LIGHT軽再始動 (light restart) をデータ共用環境で実行するかどうかを指定します。

(NO)軽再始動を行いません。

(YES)軽再始動を行うことを指定します。DB2 は記憶域が削減された状態で開始され、保持ロックを解放した後に通常どおり終了します。

-START DB2 (DB2)


#

#######################################

#############################

####################

###

#

#

DB2 を LIGHT(YES) 指定で開始した場合、ストアード・プロシージャーおよびユーザー定義関数を実行することはできません。

MSTR(jcl-substitution)システム・サービス・アドレス・スペースの始動プロシージャーを実行するJCL の EXEC ステートメントで置き換えの対象となっているパラメーターと値を指定します。

DBM1(jcl-substitution)データベース・サービス・アドレス・スペースの始動プロシージャーを実行するJCL の EXEC ステートメントで置き換えの対象となっているパラメーターと値を指定します。

DIST(jcl-substitution)分散サービス・アドレス・スペースの始動プロシージャーを実行する JCL のEXEC ステートメントで置き換えの対象となっているパラメーターと値を指定します。

(jcl-substitution)keyword = value 形式による 1 つ以上の文字ストリングで、アポストロフィで囲まれています。複数の文字ストリングを使用する場合は、各ストリングをコンマで区切りリスト全体を 1 対のアポストロフィで囲みます。

推奨事項: キーワードを省略し、始動プロシージャーで提供されるパラメーターを使用してください。

使用上の注意コマンド接頭部: インストール先に複数の DB2 サブシステムがある場合は、複数のコマンド接頭部を定義する必要があります。

条件付き再始動: 条件付き再始動制御レコードを使用することで、完全な再始動は行わず、「現在状況再ビルド」だけを指定できます。この場合、再始動中に次のアクションが行われます。

v ログ・レコードの処理が、条件付き再始動制御レコードにより判別された程度まで行われます。

v 以下の値が表示されます。– アクティブ・ログ開始の相対バイト・アドレス (RBA)

– チェックポイント・レコードの RBA

– リカバリー単位の状況カウント– 再始動作業単位エレメントの表示表

v 再始動操作は異常終了します。

ARM での軽再始動: ARM 環境で軽再始動を行えるようにするためには、DB2 および IRLM 用に ARM ポリシーをコード化する必要があります。

次の例は、DB2 用の ARM ポリシーを示しています。エレメント名の部分は、DB2

データ共用グループ名にメンバー名を連結したものとなります。例えば、DSNDB0GDB1G となります。

ELEMENT(elementname)

RESTART_METHOD(SYSTERM,STC,’cmdprfx STA DB2,LIGHT(YES)’)

-START DB2 (DB2)

第 67 章 -START DB2 (DB2) 387

#

#

次の例は、IRLM 用の ARM ポリシーを示しています。エレメント名の部分は、IRLM グループ名にその ID を連結したものとなります。例えば、DXRDB0GDJ1G001 となります。

ELEMENT(elementname)

RESTART_METHOD(SYSTERM,STC,’cmdprfx S irlmproc’)

DB2 が使用するエレメント名は、DB2 データ共用グループ名にメンバー名を連結したものになります。例えば、DSNDB0GDB1G.F となります。

開始時のエンドレス待機: システム・サービス・アドレス・スペースが開始されても、データベース・サービス・アドレス・スペースが開始できない場合は、開始操作が始まっても完了しないことがあります。一見したところエンドレス待機状態が発生したら、コンソールからシステム・サービス・アドレス・スペースを取り消し、両方の始動プロシージャーを検査して JCL エラーがないか調べます。

データ共用グループのメンバーを開始する: データ共用グループのメンバーを開始するには、グループ内のサブシステムごとに START DB2 コマンドを入力する必要があります。これがグループの最初の始動である場合、まず最初に親メンバー (最初にインストールされた DB2) を開始しなければなりません。

例例 1: DB2 サブシステムを開始します。

-START DB2

例 2: DB2 サブシステムを開始し、システム・サービス・アドレス・スペースの始動プロシージャーの REGION パラメーターに新しい値を指定します。

-START DB2 MSTR(’REGION=6000K’)

例 3: DB2 サブシステムを開始します。システム・サービス・アドレス・スペースの始動プロシージャーを実行する JCL の EXEC ステートメントが記号 RGN を使用するものと想定し、その記号に値を指定します。

-START DB2 MSTR(’RGN=6000K’)

例 4: DB2 サブシステム DB1G および DB2G は、データ共用グループのメンバーです。両方とも STARTED というコマンド接頭部範囲を指定してインストールされました。適切なコマンドを、それらを開始する z/OS システム、MVS1 およびMVS2 に経路指定することで DB1G と DB2G を開始します。

ROUTE MVS1,-DB1G START DB2ROUTE MVS2,-DB2G START DB2

-START DB2 (DB2)


第 68 章 -START DDF (DB2)

DB2 コマンド START DDF は、分散データ機能 (DDF) がまだ開始していなければそれを開始します。

省略形: -STA DDF


v 『環境』

v 『許可』

v 『構文』







構文

�� START DDF ��

使用上の注意START DDF コマンドは、VTAM および TCP/IP への DDF インターフェースをアクティブ化します。STOP DDF MODE(SUSPEND) の後にこのコマンドを発行すると、中断していたスレッドが再開され、DDF アクティビティーが続行されます。


例分散データ機能を開始します。

-START DDF

-START DDF (DB2)


第 69 章 -START FUNCTION SPECIFIC (DB2)

DB2 コマンド START FUNCTION SPECIFIC は、停止されている外部関数を開始します。別の関数にソースがある組み込み関数またはユーザー定義関数は、このコマンドで開始することはできません。

コマンドが正常終了すると、指定された関数のキューにある要求が実行を開始します。これらの関数の異常終了カウントは、ゼロに設定されます。

DB2 に新しい関数を定義する時に START FUNCTION SPECIFIC コマンドを出す必要はありません。DB2 は、新しい関数を呼び出す最初の SQL ステートメントで、自動的に新しい関数を開始します。

DISPLAY FUNCTION SPECIFIC 報告書のヒストリー統計 (MAXQUE、TIMEOUT)

は、その関数に START FUNCTION SPECIFIC コマンドが出されるたびにリセットされます。

省略形: -STA FUNC SPEC


v 『環境』

v 『許可』





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


許可このコマンドを実行するには、各機能に対して次の権限のいずれかを含む処理の特権セットを使用する必要があります。v 関数の所有権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限


|

|

START FUNCTION SPECIFIC *.* または schema.partial-name* を指定する場合、処理の特権セットに次の権限のいずれかを含める必要があります。v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限


構文

�� START FUNCTION SPECIFIC

�

(*.*)

,


�

�LOCAL

SCOPE ( GROUP ) ��

オプションの説明* (アスタリスク)(*.*)すべてのスキーマ内のすべての関数を開始します。これはデフォルトです。

(schema.specific-function-name)スキーマ内の特定の関数名を開始します。SQL の場合と同じ方法で関数名を指定することはできません。特定名を使用しなければなりません。CREATE

FUNCTION ステートメントで特定の名前を指定しなかった場合は、SYSIBM.SYSROUTINES を照会して正しい特定名を調べてください。



(schema.partial-name*)指定されたスキーマ内のすべての関数または関数のセットを開始します。セット内のすべての関数の特定名は、partial-name で始まり、任意のストリング (空白ストリングを含む) で終わることができます。例えば、schema1.ABC* は、schema1 内の ABC で始まる特定名を持つ、すべての関数を開始します。


(LOCAL)コマンドは現行メンバーにのみ適用されることを指定します。

-START FUNCTION SPECIFIC


|

|||||||||||||||||||||||||||||||

|||||||||||||||||||

|

|

|

|

(GROUP)コマンドはデータ共用グループの全メンバーに適用されることを指定します。

使用上の注意WLM 設定ストアード・プロシージャーのアドレス・スペース内の言語環境プログラム: START FUNCTION SPECIFIC コマンドは、 WLM 設定ストアード・プロシージャーのアドレス・スペース内の言語環境プログラムをリフレッシュしません。WLM コマンドを出す必要があります。例えば、ユーザー定義関数ロード・モジュールの新しいコピーを得るため、言語環境プログラムを最新にする必要がある場合は、次の WLM コマンドを出します。

VARY WLM, APPLENV=applenv,REFRESH

例例 1: すべての関数を開始します。


次のような出力が生成されます。

DSN9022I - DSNX9COM ’-START FUNC’ NORMAL COMPLETION

例 2: 関数 USERFN1 と USERFN2 を開始します。これらの関数に対する要求がキューにある場合、関数が実行されます。

-START FUNCTION SPECIFIC(PAYROLL.USERFN1,PAYROLL.USERFN2)

次のような出力が生成されます。

DSN9022I - DSNX9COM ’-START FUNC’ NORMAL COMPLETION


第 69 章 -START FUNCTION SPECIFIC (DB2) 393

|

|

|

第 70 章 START irlmproc (z/OS IRLM)

START irlmproc コマンドは、お客様システム環境で定義されたプロシージャーにより IRLM コンポーネントを開始するときに使用します。プロシージャー内の記号パラメーターは、START irlmproc コマンド上でオーバーライドできます。


v 『環境』

v 『許可』

v 『構文』






構文

�� START �

,

irlmproc,DEADLOK=’iiii,kkkk’IRLMGRP=’irlm-group-name’IRLMID=nIRLMNM=irlmnameLOCKTABL=irlmltnmLTE=nnnnMAXCSA=MAXUSRS=nnnPC=PGPROT= YES

NOSCOPE= LOCAL

GLOBALNODISCON

TRACE= NOYES

��


オプションはコンマで区切る必要があり、スペースは入れません。


開始する IRLM のプロシージャー名を指定します。

以下のいずれのオプションも必須ではありません。

DEADLOK='iiii,kkkk'ローカル・デッドロック検出の秒間隔 (iiii) と、グローバル検出が開始される前に発生するローカル・サイクル数 (kkkk) を指定します。

iiii 1 から 9999 までの 1 ～ 4 桁の数字で、IRLM がローカルでデッドロックを検出する間隔 (秒数) を指定します。1 から 9999 までの任意の値を指定できますが、指定した値が 5 より大きい場合、IRLM は 5 を使用します。

kkkk

1 から 9999 までの 1 ～ 4 桁の数字で、何回ローカル・デッドロック・サイクル数を経過すると、グローバル・デッドロックとして検出するか指定します。1 から 9999 の任意の値を指定できますが、IRLM では 1 を使用します。推奨値は 1 です。

データ共用環境は、IRLM はグループ内のすべての DEADLOK 値と、グループに加わるための最後の IRLM に指定した値との同期をとります。DEADLOK 値は、希望する値を指定したメンバーを開始することで、変更することができます。混乱を少なくするため、インストール時にはその IRLM 始動プロシージャーのすべてで DEADLOK に同じ値を指定し、間隔を元の値から増やす必要がある場合にのみ START irlmproc コマンドでこの値をオーバーライドするようお勧めします。

IRLMGRP='irlm-group-name'システム間カップリング・ファシリティー (XCF) グループの名前を指定します。データ共用環境で IRLM は、同じデータを共用する DBMS 用のロック・マネージャーとしてこのグループに所属しています。同じグループ内のすべての IRLM は LOCKTABL には同じ値を、また IRLMID には固有の値を指定しなければなりません。

グループ名は XCF グループ名として使用されます。名前の先頭には「SYS」を指定することはできず、また LOCKTABL に指定した名前と同じ名前を使用することはできません。

非データ共用環境 (SCOPE=LOCAL)、IRLMGRP は無視されます。

IRLMID=n

データ共用グループ内で IRLM を区別する場合に使用する 10 進数を指定します。

n は 1 から 255 までの 1 ～ 3 桁の数字、または引用符で囲んだ印刷可能文字です。この IRLM ID は、グループに属することができる IRLM メンバーの限界値とは直接関係はありません。その限界値は、現在のハードウェア限界値 (現在は 32) によって決まります。

START irlmproc (z/OS IRLM)


n を印刷可能文字として指定すると、IRLM はその印刷可能文字の EBCDIC

値を IRLMID (X'C4' など) として使用します。印刷可能文字は必要な数の単一引用符で囲み、 IRLM がその文字を印刷可能文字として認識できるようにします。このオペレーティング・システムによる引用符の解釈方法が原因で、文字の両側に単一引用符を付ける必要があります。例えば、印刷可能文字 'D' を指定する場合は、IRLMID='D' として指定する必要があります。

固有の IRLMID は、グループ内の IRLM (GROUP オプションに指定されたのと同じ値をもつ IRLM) ごとに指定しなければなりません。

IRLMNM=irlmname

この IRLM に割り当てられる 4 バイトの z/OS サブシステム名を指定します。 (z/OS は 4 バイトより小さな名前を受け入れますが、IRLM では 4

バイトの名前が必要になります。)

LOCKTABL=irlmltnm

このグループで使用するロック表を指定します。このオプションは IMS 環境で必要となるため、DB2 によりオーバーライドされます。

非データ共用環境 (SCOPE=LOCAL)、LOCKTABL は無視されます。

LTE=nnnn

カップリング・ファシリティー (CF) ロック構造に必要なロック表のエントリー数を 1048576 エントリーを 1 単位とした単位数で指定します。LTE=

は、ブランク、ゼロ、または最大 1024 (これを含む) までの 2 の累乗の整数値を持つことができます。グループのロック表のエントリー数は、初期構造割り振り時または REBUILD 時にグループに接続する最初の IRLM によって決まります。

LTE 値は、次の順序で使用されます。

1. MODIFY irlmproc,SET,LTE= を使用して指定された値 (値がゼロより大きい場合)。

2. irlmproc の LTE= からの値 (値がゼロより大きい場合)。

3. 既存の論理によって算定された値。これは、IXCQUERY 呼び出しで戻された XES 構造サイズを LTE 幅の 2 倍で除算します。結果を最近隣の2 の累乗に丸めて、これを既存の論理は値として使用します。

注: LTE 幅は、MAXUSRS 値によって決まります。

IRLM が使用しようとした MODIFY irlmproc,SET,LTE= からの値が、XES

IXCQUERY によって戻された構造サイズで使用可能な記憶域より大きい場合、irlmproc の LTE= が使用されます。この値が使用可能な記憶域より大きい場合、IRLM は既存の論理によって算定された値を使用します。

表 29. ロック表エントリーの一部の共通値およびロック表用記憶域の必要量

LTE=

2 バイト・エントリーのロック表用記憶域必要量


8 16 MB 32 MB

16 32 MB 64 MB

32 64 MB 128 MB

64 128 MB 256 MB

128 256 MB 512 MB


第 70 章 START irlmproc (z/OS IRLM) 397

表 29. ロック表エントリーの一部の共通値およびロック表用記憶域の必要量 (続き)

LTE=



256 512 MB 1024 MB

MAXCSA=MAXCSA= は、必須の定位置パラメーターですが、現在は使用されていません。

MAXUSRS=nnn

データ共用グループにおけるメンバーの初期の最大数を指定します。IRLM

は、構造割り振りの原因となる IRLM インスタンスのみに対してMAXUSRS 設定を支持します。この指定値により、ロック構造のロック表部分にある各ロック・エントリーのサイズが決まります (表 30 を参照)。

表 30. 初期ロック表エントリー・サイズに対する MAXUSRS の影響

MAXUSRS ロック・エントリーの初期サイズ

7 以下 2 バイト

≥ 8 で < 24 4 バイト

≥ 24 で < 33 8 バイト

nnn には 1 ～ 32 までを、1 ～ 2 桁の数字で指定してください。デフォルトは 7 です。推奨値は 7 以下です。

非データ共用環境 (SCOPE=LOCAL)、MAXUSRS は無視されます。

PC=PC= は、必須の定位置パラメーターですが、現在は使用されていません。

PGPROT=共通記憶域に常駐する IRLM ロード・モジュールを z/OS ページ保護記憶域に置くかどうかを指定します。

YES 共通記憶域に常駐する IRLM ロード・モジュールを z/OS ページ保護記憶域に置くことを指定します。

NO 共通記憶域に常駐する IRLM ロード・モジュールを z/OS ページ保護記憶域に置かないことを指定します。

SCOPE=IRLM をデータ共用環境で使用するかどうかを指定します。

LOCALIRLM が非データ共用環境にあり、そこにシステム間共用がないことを指定します。

GLOBALIRLM がデータ共用環境にあり、システム間共用を実行することを指定します。

NODISCONIRLM がデータ共用環境にあり、システム間共用を実行することを指定します。IRLM は、識別されている DBMS がなくても、データ共用グ



#

#

#

#

#

##

##

##

##

###

#

#

#

ループに接続されたままです。この場合、IRLM を停止するには、明示的に IRLM 停止を行う必要があります。

NODISCON オプションを指定した場合、DB2 サブシステムが失敗した場合に他のシステムに与える影響が少なくてすみます。その理由は、IRLM が停止したときにオペレーティング・システムが通常実行する、いくつかのリカバリー処理を実行する必要がないためです。NODISCON

オプションを使用すれば、DB2 サブシステムが正常終了または異常終了した後、より速く DB2 を再始動できる可能性があります。その理由は、IRLM が IRLM データ共用グループに再結合するのを待たなくてよいからです。

TRACE=IRLM が、ラップ・アラウンド IRLM バッファーにトレースを取り込むかどうかを指定します。それぞれのバッファーは、前のバッファーがいっぱいになると再利用されます。トレースは、IRLM の始動時に取り込まれます。トレースを循環方式にするには、irlmproc に TRACE=YES を指定する必要があります。

NOTRACE CT コマンドが出されない限り、トレースを取り込みません。詳しくは、 461ページの『第 85 章 TRACE CT (z/OS IRLM)』を参照してください。

YESラップアラウンド・バッファーにトレースを取り込みます。

例例: このコマンドは、ロック表の各エントリーが 2 バイト幅であると想定して、64

MB のロック表記憶域サイズを使用して IRLM を開始します。

システム・コンソールで次のコマンドを入力します。

S irlmproc,LTE=32

この値が正しい場合、ロック構造に正常に接続された後で表示されるメッセージDXR132I に、IRLM によって使用された値が表示されます。この値が正しくない場合、START は DXR116E CODE=24 と ABENDU2018 で終了します。この値は、SCOPE=GLOBAL または SCOPE=NODISCON のとき、IRLM によって計算されたデフォルト値がある場合にのみ使用されます。


第 70 章 START irlmproc (z/OS IRLM) 399

第 71 章 -START PROCEDURE (DB2)

DB2 確立および WLM 確立の両方のストアード・プロシージャー用アドレス・スペースの場合、DB2 コマンド START PROCEDURE は停止しているストアード・プロシージャーの定義をアクティブ化します。ストアード・プロシージャー名は、スキーマ名を付けて修飾することができます。

以下のいずれかの状況も生じます。

v DB2 確立のストアード・プロシージャー用アドレス・スペースが DB2 に接続されていない場合は、オペレーティング・システムがそのアドレス・スペースを始動します。

v ストアード・プロシージャー用アドレス・スペースがすでに DB2 に接続されており、コマンドに一覧指定された一部のプロシージャーが停止している場合、DB2 は言語処理環境環境を停止してから再始動します。DB2 は再始動時に、既存のストアード・プロシージャー・ロード・モジュールをメモリーから削除します。削除されたロード・モジュールは、そのプロシージャーに対する CALL ステートメントを実行すると再ロードされます。WLM 確立のストアード・プロシージャー用アドレス・スペースの場合、再ロードを行うために WLM コマンドが必要です。例えば、次のようになります。

MVS VARY WLM,APPLENV=applenv,REFRESH

コマンドが正常終了すると、指定されたストアード・プロシージャーへのキューイング化された要求が実行を開始します。指定されたプロシージャーの異常終了カウントは、ゼロに設定されます。DB2 は START PROCEDURE コマンドが実行されるたびに、MAXQUE および TIMEOUT 統計を 0 にリセットします。

新しいストアード・プロシージャーを DB2 に定義するとき、 START

PROCEDURE を出す必要はありません。DB2 は新しいプロシージャーのためのSQL CALL ステートメントを最初に受け取った時点で、新しい定義を自動的にアクティブ化します。

省略形: -STA PROC









#

#

#

#



許可このコマンドを実行するには、次の権限のいずれかを含む処理の特権セットを使用する必要があります。v ストアード・プロシージャーの所有権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限


構文

�� START PROCEDURE

�

(*.*)

,


�

�LOCAL

SCOPE ( GROUP ) ��

オプションの説明(*.*)すべてのスキーマ内のすべてのストアード・プロシージャーを、呼び出し可能としてマークを付けます。

(schema.procedure-name)指定されたスキーマ内の指定されたストアード・プロシージャーを開始します。

(schema.partial-name*)指定されたスキーマ内のストアード・プロシージャーのセットを開始します。このセット内のすべてのプロシージャーの名前は partial-name で始まり、任意のストリング (空白ストリングを含む) で終わることができます。例えば

-START PROCEDURE (DB2)


|

|

|

|||||||||||||||||||||||||||||||||||||

|||||||||||||||||||

|

PAYROLL.ABC* は、PAYROLL スキーマ内の ABC で始まる名前を持つすべてのストアード・プロシージャーを開始します。

procedure-name

1 つ以上の特定のストアード・プロシージャーを、呼び出し可能としてマークします。

partial-name*SYSPROC スキーマ内のストアード・プロシージャーのセットに、呼び出し可能のマークを付けます。このセット内のすべてのプロシージャーの名前はpartial-name で始まり、任意のストリング (空白ストリングを含む) で終わることができます。例えば ABC* を指定すると、SYSPROC スキーマ内の ABC で始まる名前のすべてのストアード・プロシージャー名を開始します。


(LOCAL)指定されたストアード・プロシージャーをローカル・メンバー内でのみ開始します。

(GROUP)データ共用グループのすべてのメンバー内の指定されたストアード・プロシージャーを開始します。

使用上の注意ストアード・プロシージャーの定義エラー: ストアード・プロシージャーのエラーは、作成時に検出されます。詳しくは、「DB2 SQL 解説書」第 5 章の CREATE

PROCEDURE を参照してください。

ストアード・プロシージャーのアドレス・スペースの管理: START PROCEDURE

コマンドは、DB2 ストアード・プロシージャーのアドレス・スペースがどのように管理されるかにより、働き方が異なります。WLM 確立のストアード・プロシージャー用アドレス・スペースは、START PROCEDURE コマンドではなく、WLM によって制御されます。詳しくは、「DB2 管理ガイド」第 5 部 (第 2 巻) を参照してください。

例例 1: すべてのストアード・プロシージャーを開始します。

-START PROCEDURE


DSNX946I - DSNX9ST2 START PROCEDURE SUCCESSFUL FOR *.*DSN9022I - DSNX9COM ’-START PROC’ NORMAL COMPLETION

例 2: ストアード・プロシージャー USERPRC1 および USERPRC2 を呼び出し可能にし、これらのプロシージャーを待っているすべての要求を開始します。

-START PROCEDURE(USERPRC1,USERPRC2)



第 71 章 -START PROCEDURE (DB2) 403

|

|

|

|

|

|

DSNX946I - DSNX9ST2 START PROCEDURE SUCCESSFUL FOR USERPRC1DSNX946I - DSNX9ST2 START PROCEDURE SUCCESSFUL FOR USERPRC2DSN9022I - DSNX9COM ’-START PROC’ NORMAL COMPLETION



第 72 章 -START RLIMIT (DB2)

DB2 コマンド START RLIMIT は、リソース限定機能 (管理プログラム) を開始し、使用する機能のリソース限定表を指定するときに使用します。

START RLIMIT は、リソース限定機能がすでにアクティブである場合でも、発行可能です。指定されたリソース限定表は新しいスレッドに使用され、既存のスレッドは引き続きその作成時にアクティブであった表の制限を受けます。

省略形: -STA RLIM


v 『環境』

v 『許可』

v 『構文』







構文

�� START RLIMITID=id

��


オプションの説明次のキーワードはオプションです。

ID=id

管理プログラムが使用するリソース限定表を指定します。

id は、表の作成時に指定される 1 文字または 2 文字の識別文字です。リソース限定表について詳しくは、「DB2 管理ガイド」第 5 部 (第 2 巻) を参照してください。

この表のフルネームは authid.DSNRLSTid です。この authid は、インストール・パネル「DSNTIPP」のフィールド「RESOURCE AUTHID」に指定される値です。

デフォルトの ID は、インストール・パネル「DSNTIPO」のフィールド「RLST

NAME SUFFIX」で指定される値です。

例リソース限定機能を開始します。

-START RLIMIT ID=01

-START RLIMIT (DB2)


第 73 章 -START TRACE (DB2)

DB2 コマンド START TRACE は、DB2 トレースを開始します。トレース機能について詳しくは、「DB2 管理ガイド」第 5 部 (第 2 巻) を参照してください。

このコマンドにはもう 1 つのオプションがあり、またその他のいくつかのオプションにも追加の値があります。この追加情報は、IBM ソフトウェア・サポートの指示のもとで保守し、使用するようになっています。詳しくは、「DB2 Diagnosis Guide

and Reference」を参照してください。

省略形: -STA TRA


v 『環境』

v 『許可』



v 411ページの『制約ブロック』










|

|

構文

�� START TRACE ( PERFM )ACCTGSTATAUDITMONITOR

destination block constraint block COMMENT(string)�

�LOCAL

SCOPE ( GROUP )

��

destination block:

��

,

DEST( GTF )SMFSRVOPnOPX

��

constraint block:

��

*,


*,

AUTHID( authorization-id ) �

*,


� �

*,

(1)IFCID( ifcid )

*BUFSIZE( k_bytes ) �

,

TDATA( CORRELATION )TRACECPUDISTRIBUTED

�

�

�

LOCATION( * ),

location-name<luname>ipaddr

��

注:

1 CLASS オプションで、アクティブ化された IFCID に加え、トレース・イベントを指定することができます。詳細については、414 ページの IFCID(ifcid, ...) の説明を参照してください。

-START TRACE (DB2)


|

|||||||||||||||||||||||||||||||||||||||||||||

||||||||||||||||||||||||

|

オプションの説明トレースのタイプを指定する必要があります。

オプション PERFM、ACCTG、STAT、AUDIT、および MONITOR は、開始されたトレースのタイプを識別するものです。

(PERFM)パフォーマンスの分析とチューニングを目的とするトレースを指定します。このトレースには、システムの特定のイベントに関するレコードが含まれます。

省略形: P

(ACCTG)特定のプログラムまたは許可 ID のアカウンティングで使用することを目的とするトレースを指定します。このトレースには、各スレッドごとに書き込まれるレコードが含まれます。

省略形: A

(STAT)DB2 の各種コンポーネントが出す統計データを、インストール中に選択できる時間間隔で収集するためのトレースを指定します。

省略形: S

統計トレースを選択する場合、LOCATION は指定できません。

(AUDIT)DB2 の各種コンポーネントから監査データを収集するトレースを指定します。

省略形: AU

(MONITOR)モニター・データを収集するトレースを指定します。このオプションは、トレース・データを DB2 モニター・アプリケーション・プログラムで使用できるようにします。

省略形: MON


(LOCAL)ローカル・メンバーについてのみ、プロシージャーの情報を表示するように指定します。

(GROUP)データ共用グループの全メンバーについて、プロシージャーの情報を表示するように指定します。

COMMENT(string)トレース出力 (常駐のトレース・テーブルを除く) に複製されるコメントを付けます。このオプションは、コマンドが出された理由を記録するために使用できます。

string は任意の文字ストリングです。ブランク、コンマ、または特殊文字を含んでいる場合はアポストロフィで囲む必要があります。

-START TRACE (DB2)

第 73 章 -START TRACE (DB2) 409

|

|

|

|

|

|

|

|

DESTどこにトレース出力を記録するかを指定します。複数の値を使用できますが、同じ値を 2 回使用してはなりません。この値を指定しないと、トレース出力は表31 に示されているデフォルト宛先に送られます。

指定の宛先がアクティブでないか、START TRACE コマンドを出した後で非アクティブになると、メッセージ DSNW133I が出力されます。このメッセージは、トレース・データが失われたことを示します。これは GTF、SRV、 SMF

といった宛先に適用されます。さらに、OPn や OPX といった宛先についても、アプリケーション・プログラムが START TRACE を出さないとこのメッセージを受け取ります。

省略形: D

指定可能な値とデフォルト値は、開始されるトレースのタイプにより異なります(表 31 を参照)。

表 31. トレース・タイプごとの指定可能な宛先

タイプ GTF SMF SRV OPn OPX

PERFM デフォルト指定可能指定可能指定可能指定可能

ACCTG 指定可能デフォルト指定可能指定可能指定可能

STAT 指定可能デフォルト指定可能指定可能指定可能

AUDIT 指定可能デフォルト指定可能指定可能指定可能

MONITOR 指定可能指定可能指定可能指定可能デフォルト

各値の意味は以下のとおりです。

GTFz/OS 汎用トレース機能 (GTF)。DB2 からのレコード ID は X'0FB9' です。

SMFシステム管理機能。DB2 トレース・レコードの SMF レコード・タイプは、以下に示すように、IFCID レコードによって異なります。

IFCID レコード SMF レコード・タイプ

1 (System Services Statistics) 100

2 (Database Services Statistics) 100

3 (Agent Accounting) 101

202 (Dynamic System Parameters)

100

230 (Data Sharing Global Statistics)

100

239 (AGENT ACCOUNTING OVERFLOW)

101

All Others 102

-START TRACE (DB2)


SRVユーザー作成ルーチンへの出口。このようなルーチンを作成する方法とその例については、ライブラリー prefix.SDSNMACS のマクロ DSNWVSER を参照してください。

OPn

特定の宛先。

n には 1 ～ 8 の整数を指定できます。

OPX最初の空き OPn スロットを使用する総称宛先。

OPn バッファーに対するトレースを開始するアプリケーションだけが、そのバッファーを読み取ることができます。アプリケーション・プログラムからトレースを開始する方法について詳しくは、「付録 E (第 2 巻) DB2 管理ガイド」を参照してください。

OPX 宛先へのトレースは、バッファーが未使用としてマークされる前にすべて停止しなければなりません。前に使用中であった OPX バッファーに対してトレースを開始すると、前のトレースが設定していた記憶域はそのトレースによって上書きされます。

制約ブロックトレースによって収集されるデータの種類は、制約ブロックによって任意指定の制約を受けます。指定可能な制約は、開始されるトレースのタイプによって異なります (表 32 を参照)。

表 32. トレース・タイプごとの指定可能な制約

タイプ PLAN AUTHID CLASS LOCATION

PERFM 指定可能指定可能指定可能指定可能

ACCTG 指定可能指定可能指定可能指定可能

STAT NO NO 指定可能 NO

AUDIT 指定可能指定可能指定可能指定可能

MONITOR 指定可能指定可能指定可能指定可能

以下は、各オプションの意味です。

PLAN(plan-name, ...)トレース情報の収集が行われる特定プランのリストを指定します。このオプションは STAT トレースには使用できません。

デフォルトは PLAN(*) です。

(*) すべてのプランのトレースを開始します。

plan-name

アプリケーション・プランの名前です。8 つまでの名前を使用でき、名前ごとに別々のトレースが開始されます。複数の名前を使用する場合、AUTHID

および LOCATION に使用できる値は 1 つだけです。

-START TRACE (DB2)


AUTHID(authorization-id, ...)トレース情報の収集が行われる特定許可 ID のリストを指定します。指定される許可 ID は、1 次許可 ID でなければなりません。このオプションは STAT

トレースには使用できません。

デフォルトは AUTHID(*) です。

(*) すべての許可 ID のトレースを開始します。

authorization-id

許可 ID を指定します。8 つまでの ID を使用でき、ID ごとに別々のトレースが開始されます。複数の ID を使用する場合、PLAN およびLOCATION に使用できる値は 1 つだけです。

CLASS(integer, ...)収集されるデータのクラスのリストを指定します。指定可能なクラスとその意味は、開始されるトレースのタイプによって異なります。

省略形: C

このオプションを省略すると、トレース・タイプ内のデフォルトのクラスがすべてアクティブ化されます。各トレース・タイプのデフォルトのクラスには、表33 でアスタリスク (*) が付けられています。

(*) トレース・タイプのすべてのクラスのトレースを開始します。

integer

下表にあるいずれかの番号です。開始されるトレースのタイプに可能なクラスの任意の番号を使用することができます。

表 33. DB2 トレース・タイプのクラス

クラスクラスの説明アクティブ化された IFCID

アカウンティング・トレース

1* 標準アカウンティング・データ 3,106,239

2 DB2 イベントの開始または終了信号 232

3 DB2 での経過待機時間 6-9,32,33,44,45,117,118,127,128,170,171,

174,175,213-216,226,227,242,243,321,322,329

4 お客様が定義したアカウンティング・レコード 1 151

5 IFI 要求の処理に費やされた時間 187

6 予約済み

7 パッケージおよび DBRM アカウンティングについての DB2 イベントの開始または終了信号

232,240

8 パッケージの待機時間 6-9,32,33,44,45,117,118,127,128,170,171,

174,175,213-216,226,227,241-243,321,322

10 パッケージの詳細 239

11 - 29 予約済み

30 - 32 ローカル使用可能

監査トレース

1* 許可が不適切なため拒否されたアクセスの試み 140

2 明示的な GRANT および REVOKE 141

-START TRACE (DB2)


表 33. DB2 トレース・タイプのクラス (続き)


3 監査される表に対する CREATE、ALTER、および DROP 操作

142

4 監査されるオブジェクトの最初の変更 143

5 監査されるオブジェクトの最初の読み取り 144

6 監査されるオブジェクトに関係する SQL ステートメントのバインド時情報

145

7 許可 ID の割り当てまたは変更 55,83,87,169,312

8 ユーティリティー 23,24,25

9 お客様が定義した監査レコード 1 146

10 - 29 予約済み


統計トレース

1* 統計データ 1,2,105,106,202

2 インストール先定義統計レコード 1 152

3 デッドロック、ロック・エスカレーション、グループ・バッファー・プール、データ・セット拡張情報、および長く実行されている UR とアクティブ・ログ・スペース不足の表示

172,196,250,258,261,262,313,330,337

4 DB2 例外条件 173,191-195,203-210,235,236,238,267,268

5 DB2 データ共用統計レコード 230

6 記憶域使用の詳細 225

7 予約済み

8 データ・セット入出力統計 199

9 - 29 予約済み


パフォーマンス・トレース

1* バックグラウンド・イベント 1,2,31,42,43,76-79,102,103,105-107,153

2* サブシステム・イベント 3,68-75,80-89,106,174,175

3* SQL イベント 22,53,55,58-66,92,95-97,106,112,173,177,

233,237,250,272,273,325

4 バッファーおよび EDM プールに対する読み書き 6-10,29-30,105-107,127,128,226,227,321,322

5 ログへの書き込み ; アーカイブ・ログ 32-41,104,106,114-120,228,229

6 要約ロック情報 20,44,45,105-107,172,196,213,214,218,337

7 詳細ロック情報 21,105-107,223

8 データ走査明細 13-18,105-107,125,221,222,231,305,311

9 ソート明細 26-28,95-96,106

10 BIND、コマンド、およびユーティリティーの明細

23-25,90,91,105-107,108-111,201,256

11 実行単位切り替えおよびラッチ競合 46-52,56,57,93,94,106,113

12 記憶域管理機能 98-101,106

13 編集および妥当性検査終了 11,12,19,105-107

-START TRACE (DB2)


#

|

##

表 33. DB2 トレース・タイプのクラス (続き)


14 アプリケーションの開始と終了 67,106,121,122

15 お客様が定義した定義パフォーマンス・レコード1

154

16 分散処理 157-163,167,183

17 クレームおよびドレーン情報 211-216

18 - 19 予約済み

20 データ共用一貫性要約 249-251,256-257,261,262,267,268

21 データ共用一貫性明細 255,259,263

22 許可出口パラメーター 314

23 - 29 予約済み


モニター・トレース

2 DB2 イベントの開始または終了信号 232

3 入出力、ロックに対する DB2 の待機時間 ; リソース使用情報

6-9,32,33,44,45,117,118,127,

128,170,171,174,175,213,214,

215,216,226,227,242,243,321,322

4 お客様が定義したモニター・レコード1 155

5 IFI 要求の処理に費やされた時間 187

6 DATA CAPTURE CHANGES により作成される表への変更

185

7 パッケージおよび DBRM アカウンティングについての DB2 イベントの開始または終了信号

232,240

8 パッケージの待機時間 6-9,32,33,44,45,51,52,56,57,

117,118,127,128,170,171,174, 175,213-

216,226,227,241-243,321,322

10 パッケージの詳細 239

9, 11- 29 予約済み


注:

v アスタリスク (*) は、トレース・タイプのデフォルトのクラスであることを示します。

v 1. IFCID の使用手順は、「DB2 管理ガイド」付録 D (第 2 巻) を参照してください。

v 2. IFCID 318 がアクティブになっていない場合、DB2 ではこのレコードの統計データを収集しません。IFCID 318

はどのトレース・クラスとも関連しておらず、これ自体で開始する必要があります。

IFCID(ifcid, ...)CLASS オプションに指定されたクラスに含まれる IFCID に加えて、開始する他の IFCID (トレース・イベント) を指定します。IFCID オプションに指定された IFCID だけを開始するには、トレース・クラス 30 ～ 32 を使用してください。これらのクラスには事前定義された IFCID がないため、ロケーションはこれらのクラスを使用できます。(IFCID オプションに指定されたトレース・イベントだけをアクティブ化する例については、 417ページの『例 1』を参照してください。)

-START TRACE (DB2)


IFCID オプションを指定しないと、アクティブ化されたトレース・クラスに含まれる IFCID だけが開始されます。

IFCID の最大数は 156 です。また、IFCID オプションで有効な値の範囲は 1

～ 350 です。ただし、4、5、185、187、217、232、234、240、241 は例外です。これらの例外は IFCID オプションでは無効な値です。IFCID の 4 および5 は、常に自動的にアクティブになります。その他の無効な IFCID の中には、特定のトレース・クラスによってのみアクティブ化できるものもあります。トレース・クラスによってのみ開始できる IFCID オプションの無効な値については、以下に記載します。

開始するには開始されるトレース・クラスIFCID 185 モニター・トレース・クラス 6

IFCID 232 モニター・トレース・クラス 2 または 7、あるいはアカウンティング・トレース・クラス 2 または 7

IFCID 240 モニター・トレース・クラス 7、あるいはアカウンティング・トレース 7

IFCID 241 モニター・トレース・クラス 8、あるいはアカウンティング・トレース 8

デフォルトは IFCID(*) です。

BUFSIZE(k_bytes, ...)トレース・データを受け取る IFC 管理のバッファーのサイズを指定します。このオプションを指定できるのは、OPn 宛先を指定した場合だけです。

k_bytes の範囲は 256 KB から 16384 KB までです。この数値は 4 で割り切れることが必要です。指定した値がこの範囲外にある場合は、指定値に最も近い範囲限度が使用されます。バッファー・サイズとして 256KB を割り振る場合は、BUFSIZE(256) と指定します。

デフォルトは BUFSIZE(*) です。これは、DB2 のインストール時に設定されたサイズです。

TDATA各トレース・レコードのプロダクト・セクションに付けられるプロダクト・セクションのヘッダーを指定します。TDATA を指定しない場合は、トレースのタイプによってプロダクト・セクションのヘッダーが決められます。トレース・レコードのプロダクト・セクションには、複数のヘッダーを入れることができます。

IFC レコードには、すべて標準の IFC ヘッダーがあります。アカウンティング、パフォーマンス、監査、およびモニターのレコードには、相関ヘッダーが加えられます。保守容易性レコードにはトレース・ヘッダーが追加されます。

CORRELATIONレコードに相関ヘッダーを付けます。

省略形: COR

TRACEレコードにトレース・ヘッダーを付けます。

省略形: TRA

-START TRACE (DB2)


#

#

#

#

CPUレコードに CPU ヘッダーを入れます。CPU ヘッダーには、z/OS TCB または SRB の実行における現在のプロセッサー時間が示されます。

DISTRIBUTEDレコードに分散ヘッダーを付けます。

省略形: DIST

LOCATION(location-name, ...)トレース情報の収集が行われる特定のロケーション名のリストを指定します。LOCATION オプションを使用すると、分散データ関連を持たないトレース・スレッドは除かれます。統計トレースを開始したい場合は、LOCATION は指定できません。

location-name

分散スレッドをトレースする DB2 サブシステムを識別します。location-name で指定するリモート TCP/IP または SNA ロケーションのDB2 トレースをアクティブ化します。

ロケーションは eight つまで指定でき、それぞれに対して別々のトレースが開始されます。複数のプラン名または許可 ID を使用する場合には、ロケーションは 1 つだけ指定できます。

<luname>

luname に指定したリモート SNA LU 名を介して DDF に接続されるリモート・クライアントについて DB2 トレースをアクティブ化します。

ipaddr

リモート TCP/IP ホストを介して DDF に接続されたリモート・クライアントの DB2 トレースをアクティブ化します。nnn.nnn.nnn は、ドット 10 進IP アドレスです。

(*) 分散スレッド下で発生したトレース・イベントを、接続されたロケーションに関係なく、開始することを指定します。ローカル・ロケーション名を指定することは、LOCATION(*) を指定することと同じです。

DB2 UDB for z/OS 以外のクライアント: DB2 UDB for z/OS は、DB2

UDB for z/OS サブシステム以外のクライアントからはロケーション名を受け取りません。DB2 UDB for z/OS サブシステム以外のクライアントのトレースを開始するには、そのクライアントの LUNAME または IP アドレスを入力してください。LUNAME を、より小 (<) 記号とより大 (>) 記号で囲んでください。この IP アドレスは、nnn.nnn.nnn.nnn の形式で入力してください。例えば、LUNAME が LULA であるクライアントについてトレースを開始するためには、次のコマンドを入力します。

-START TRACE (PERFM) CLASS (*) LOCATION (<LULA>)

IP アドレスが 123.34.101.98 であるクライアントについてトレースを開始するためには、次のコマンドを入力します。

-START TRACE (PERFM) CLASS (*) LOCATION (123.34.101.98)

-START TRACE (DB2)


使用上の注意トレースの数: PLAN、AUTHID、または LOCATION に使用する値が 1 個か、または全く値を使用しない場合、START TRACE コマンドでは単一のトレースを開始します。PLAN、AUTHID、または LOCATION で使用する値が複数の場合には、コマンドはプラン、許可 ID、またはロケーションごとにトレースを開始します。トレースは最大 32 まで同時に実行可能です。START TRACE コマンドを、コンソールまたは DB2I パネルから OPn または OPX 宛先に対して入力すると、トレース・データが失われたことを示すメッセージ DSNW133I が出されます。

モニター・トレース・クラス 1 の開始時にオプション PLAN、AUTHID、またはLOCATION を使用しても、IFI READS 要求に戻されるデータの量には影響がありません。モニター・トレース・クラス 1 の IFCID の修飾の詳細については、「付録 E (第 2 巻) DB2 管理ガイド」を参照してください。

アカウンティングまたはモニターのいずれかのトレース・クラス 2、5、または 7

の開始時に、オプション PLAN、AUTHID、または LOCATION を使用しても何の影響もありません。

DB2 の停止と開始: トレース開始後に DB2 を停止し、また開始した場合、トレースは自動的には再開されません。

SCOPE (GROUP) の指定: SCOPE(GROUP) 指定で START TRACE を発行すると、DB2 はデータ共用グループの各メンバーに対して START TRACE コマンドを実行します。データは、データ共用グループの各メンバーごとに定義されている宛先に送られます。データ共用グループの全メンバーのトレース・データを 1 箇所に集めたい場合は、IFI READA または READS 呼び出しをもつモニター・プログラムを使用して、データを収集します。詳しくは、「DB2 管理ガイド」付録 E (第 2


SCOPE(GROUP) を指定してトレースを開始し、トレースの開始後に新規メンバーがデータ共用グループに加わった場合、新規メンバーも START TRACE コマンドによって指定されたトレース・データを書き込みます。

SCOPE(GROUP) を指定してトレースを開始すると、大量のトレース・データが生成される可能性があり、追加データを保持するためにモニター・プログラムの戻り域のサイズを増やすことが必要になる場合があります。

例例 1: ロケーション USIBMSTODB21 に対しリモート・アクティビティーを行うスレッドのパフォーマンス・トレースを開始します。IFCID 44 (ロック中断) および54 (ロック競合) をアクティブ化するだけです。トレース・クラス 30 は、インストール用に使用できます。

-START TRACE (PERFM)DEST(GTF)LOCATION(USIBMSTODB21)CLASS(30)IFCID(44)

-START TRACE (DB2)


|

|

|

|

|

|

|

|

|

|

|

|

|

例 2: プラン DSN8BC81 のアカウンティング・トレースを開始します。レコードをSMF に書き込みます (デフォルトによって起きる)。トレースを識別するコメントを付けます。

-START TRACE (ACCTG)PLAN (DSN8BC81)COMMENT (’ACCTG TRACE FOR DSN8BC81’)

例 3: 統計トレースを開始します。レコードを SMF に書き込みます (デフォルトによる)。

-START TRACE=S

例 4: モニター・トレースを開始します (通常はアプリケーション・プログラムにより行われます)。レコードを OPX に書き込みます (デフォルトによる)。

-START TRACE(MON)

例 5: データ共用グループに対するモニター・トレースを開始します (通常はアプリケーション・プログラムによって行われます)。レコードを OPX に書き込みます(デフォルトによる)。

-START TRACE(MON) SCOPE(GROUP)

-START TRACE (DB2)


|

|

|

|

第 74 章 /STOP (IMS)

IMS /STOP コマンド (SUBSYS パラメーターを指定) は、アプリケーション・プログラムによる外部サブシステム・リソースへのアクセスを防ぐときに使用します。

以下は、/STOP コマンドの一部の説明に過ぎません。詳しくは、「IMS コマンド解説書」を参照してください。


v 『環境』

v 『許可』

v 『構文』







構文

�� /STOP �

,

SUBSYS subsystem-nameSUBSYS ALL

��

オプションの説明SUBSYS接続の停止を、現在 IMS に接続している外部サブシステムの 1 つ以上の名前について行うか、またはそのすべてについて行うかを指定します。

subsystem-name, ...IMS への接続を停止する外部サブシステムの名前を 1 つ以上指定します。


ALL現在 IMS に接続しているすべての外部サブシステムの接続を停止することを示します。

使用上の注意/STOP をいつ使用するか: /STOP コマンドを使用すると、外部リソースに現在アクセス中のアプリケーション・プログラムは正常に完了できます。すべてのアプリケーションが終了すると、外部サブシステムへの接続も終了します。接続を再確立するには /START コマンドを出す必要があります。

/STOP コマンドはさらに、外部サブシステムの PROCLIB メンバー項目における指定を変更する目的で、サブシステム接続を停止する際にも使用できます。その後で/START コマンドを出すと、PROCLIB の主記憶域にあるコピーは、修正された項目により最新のものにされます。

/STOP (IMS)


第 75 章 -STOP DATABASE (DB2)

DB2 コマンド STOP DATABASE は、指定したオブジェクトをアプリケーションが使用できないようにし、そのデータ・セットをクローズします。指定できるオブジェクトは、次のとおりです。

v データベース

v 表スペース

v 索引スペース

v パーティション表スペースまたは索引スペース (DPSI を収容する索引スペースも含む)

v 非パーティション 2 次索引の論理パーティション

このコマンドを 2 次索引の論理パーティションを停止するために使用した場合、このコマンドは、その索引に関連するデータ・セットをクローズしません。

データ共用環境、このコマンドはデータ共用グループのメンバーすべてに適用されます。GBP 依存のオブジェクトがコマンド STOP DATABASE によって停止した場合、DB2 はそのオブジェクトを GBP 依存でなくするのに必要な処理を実行します。

省略形: -STO DB


v 『環境』

v 『許可』







許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v STOPDB 特権v DBMAINT 権限


|

|

|

v DBCTRL 権限v DBADM 権限v SYSCTRL 権限v SYSADM 権限

このコマンドで指定されたデータベースに対する STOPDB 特権が上記権限セットにないと、このデータベースに対してエラー・メッセージが出されます。


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

データベース DSNDB06 に含まれる表スペースと索引スペースは、許可を検査する必要があります。START DATABASE 許可検査が必要な表スペースまたは索引スペースを停止させると、それを再始動するのにインストール SYSADM 権限が必要になります。

構文

�� STOP DATABASE �

,


�

�

�

�

,

SPACENAM( space-name )* ,spacename1:spacename2spacename* PART( integer )*spacename integer1:integer2*spacename**spacestring1*spacestring2*

�

�AT(COMMIT)

��

-STOP DATABASE (DB2)


オプションの説明以下の 2 つのオプションのいずれかが必要です。

(database-name, ...)停止するデータベースの名前、または停止する表スペースまたは索引スペースを含むデータベースの名前を指定します。名前が複数ある場合は、リスト中の名前をコンマで区切ってください。

(*) 処理の特権セットに少なくとも DBMAINT 権限または STOPDB 特権があるすべてのデータベースを停止させます。

ただし、DSNDB01、DSNDB06、および作業ファイル・データベース(DSNDB07 など) を停止できるのは、それらを明示的に指定した場合に限られます (例えば、STOP DATABASE(DSNDB01))。

dbname と dbstring は、以下のリストのいずれかの形式をとることができます。ここで、 dbname1 と dbname2 は、 1 ～ 8 文字の任意のストリングを表し、dbname は 1 ～ 7 文字の任意のストリングを表します。

形式停止する対象

dbname1:dbname2 データベースの名前が dbname1 以上で、dbname2 以下に照合するすべてのデータベース





SPACENAM(space-name, ...)指定された、停止するデータベース内の表スペースまたは索引の名前を示します。


space-name

停止する、1 つ以上の表スペースまたは索引スペースの名前。

以下のものを指定する場合には、space-name を database-name の場合と同様に記述することができます。v 単一の表スペースまたは索引スペースの名前v 名前の範囲v 部分的な名前 (開始部分または終了部分のパターン・マッチング文字

(*)、2 つのストリング間のパターン・マッチング文字、またはこれらの使用の任意の組み合わせを含む)。連続したパターン・マッチング文字 (*)

は許されず、またキーワード・ストリングの中に 2 つのパターン・マッチング文字を指定することはできません。

表スペースまたは索引スペースを再度開始する方法については、 425ページの『使用上の注意』を参照してください。


第 75 章 -STOP DATABASE (DB2) 423

(*) 指定されたデータベースの表スペースおよび索引をすべて停止します。

spacename と spacestring は、以下のリストのいずれかの形式をとることができます。ここで、 spacename1 と spacename2 は、 1 ～ 8 文字の任意のストリングを表し、 spacename は 1 ～ 7 文字の任意のストリングを表します。


spacename1:spacename2 名前が spacename1 以上で、 spacename2

以下に照合する、すべての表スペースまたは索引スペース




*spacestring1*spacestring2* 名前にストリング spacestring1 とspacestring2 を含むすべての表スペースまたは索引スペース

PART (integer, ...)指定された表スペースまたは索引のパーティションの内、停止する 1 つ以上のパーティションのパーティション番号を指定します。他のパーティションの START または STOP 状態は変更されません。

指定する integer は、対応するスペース名およびデータベース名の有効なパーティション番号でなければなりません。指定したパーティション番号が無効であると、無効な番号ごとにエラー・メッセージが出されますが、指定したパーティションが有効であればそれらはすべて停止されます。

以下のいずれかのように指定して、integer をコーディングできます。

v 1 つ以上のパーティションのリスト

v 照合順序が integer1 以上で integer2 以下のすべてのパーティション番号の範囲


PART は、パーティション表スペース、パーティション索引、およびパーティション表スペースの非パーティション・タイプ 2 索引について有効です。非パーティション表スペースまたは非パーティション表スペースに対する索引を PART に指定するとエラー・メッセージが出され、その非パーティション・スペースは停止されません。論理パーティションが停止していると、その索引はクローズされません。索引をクローズするには、PART を使用せずに非パーティション索引 (nonpartitioning index)を停止する必要があります。

AT(COMMIT)指定されたオブジェクトを現在 STOP 状況としてマークして新しいリクエスターがアクセスしないようにします。現時点で実行中のアプリケーションについては、次のコミットまではアクセスを続けることができます。コミット後には、コ



|

ミットしたアプリケーションによるそれ以上のアクセスは禁止されます。すべてのジョブがクレームを解放し、かつすべてのユーティリティーがこれに対するドレーン・ロックを解放した時点で、オブジェクトは実際に停止され、STOP 状況に置かれます。RELEASE(DEALLOCATE) でバインドされたスレッドを中断するには AT(COMMIT) を指定します (特にスレッドの再使用が頻繁に行われる状態では)。

このオプションは、宣言済みの一時データベースとそのデータベース内の表スペースについては無視されます。

使用上の注意明示的に停止されたデータベース: 表スペースや索引が明示的に停止された場合(SPACENAM オプションを指定した STOP DATABASE コマンドを使用して)、その表スペースや索引は START DATABASE コマンドを使用して明示的に開始する必要があります。データベースを開始しても、明示的に停止されている表スペースまたは索引は開始しません。

停止された表スペース、索引、およびパーティション: 表スペース、索引、およびパーティションは STOP DATABASE コマンドが発行されると物理的にクローズします。パーティション表スペースの非パーティション索引 (nonpartitioning index)の論理パーティションについては例外です。宣言済みの一時表用の索引スペースを停止または開始することはできません。

TSO、z/OS、およびバッチにおける操作: TSO または z/OS コンソールから STOP

DATABASE コマンドを発行した場合、このコマンドは非同期的に働き、端末は解放されたままです。コマンドがバッチ・ジョブから出されると、停止しているデータベースに後のステップが依存している場合には、コマンドは非同期的に働きます。STOP DATABASE コマンドはデータベースを停止する前に、そのデータベースに対する進行中の処理をドレーンします。最初の要求の時点でドレーン・ロックを獲得できないと、ロックの獲得を繰り返し試みます。ロック獲得の試行回数が 15

回を超えてタイムアウトになるか、あるいは重大なデッドロック状態が生じると、このコマンドは失敗します。

すべてのデータベースが停止していることを確認する: STOP DATABASE コマンドが非同期で処理されている場合、メッセージ DSN9022I がコマンドが完了する前に発行されることがあります。メッセージ DSNT736I が出されると、STOP

DATABASE コマンドの非同期処理が完了したことを示します。

データベース内の表スペースおよび索引の停止状況を検査するには、DISPLAY

DATABASE コマンドを使用します。状況が STOPP であれば、そのオブジェクトが停止の処理中であることを示します。また、状況が STOP であれば、停止はすでに完了してそのオブジェクトが停止状態にあることを示します。オブジェクトは、現在そのオブジェクトにアクセスしているすべてのアクティブ・スレッドが静止するまで、停止しません。

STOP DATABASE コマンドが正常に処理を完了しないと、オブジェクトは STOP

ペンディング (STOPP) 状況のままになる場合があります。



コミュニケーション・データベースとリソース限度データベースの停止: コミュニケーション・データベース (CDB) とリソース限定データベース (RLST) がアクティブであれば、それらを停止させることはできません。それらのデータベースは作成時にはアクティブで、また DB2 によってアクティブ化させられます。CDB について詳しくは、「DB2 インストレーション・ガイド」第 3 部を参照してください。RLST について詳しくは、「DB2 管理ガイド」第 5 部 (第 2 巻) を参照してください。

DSNDB01 の停止: アプリケーション・プランやパッケージを実行中に DSNDB01

データベースを停止しようとすると、DSNDB01 でロッキング競合が生じるためにタイムアウトになることがあります。これが最も起こりやすいのは、アプリケーション・プランまたはパッケージが DB2 の開始後初めての実行中であるか、プランのスケルトン・カーソル表 (SKCT) またはパッケージのスケルトン・パッケージ表(SKPT) が EDM プールからスワップされた場合です。

制約的な状況にある表スペース: アプリケーション処理が表スペースにあるトランザクション・ロックを要求したが、その表スペースが制約的な状況 (RECP) にあるか、または必要な索引が制約的な状況にある場合、DB2 はそのロックを獲得し、アプリケーションがその表スペースまたは索引にアクセスしようとするまでその制約的状況を検出しません。アプリケーションはその後 SQLCODE -904 (「リソースが使用不可」) を受け取り、ロックをコミットまたはロールバックすることにより(RELEASE オプションの値が COMMIT の場合)、あるいはそれを終了することにより (RELEASE オプションの値が DEALLOCATE の場合) 解放します。コマンドSTOP DATABASE を表スペースまたは索引スペースのいずれかに出した時点でトランザクション・ロックが有効であれば、そのコマンドは中断します。このコマンドはデータベースを停止する前に、進行中の作業をドレーンするのに必要なロックを獲得する試みを繰り返します。そして、ロックを獲得する試行回数が 15 回を超えるとタイムアウトになり、コマンドは失敗します。

ディスク障害の後: 障害のある装置と DB2 間の入出力インターフェースに割り込みをかけないで、STOP DATABASE コマンドを発行すると、DB2 では入出力要求が未完了となる可能性があります。このようなハング状態を避けるには、FORCE オプションを指定した z/OS コマンド VARY でその装置をオフラインにするか、あるいは障害が生じる前の装置に入出力タイミング間隔を設定することで割り込みを発生させてください。入出力タイミング間隔は、IECIOSxx z/OS parmlib メンバーを介して、あるいは次の z/OS コマンドを出すことにより設定できます。

SETIOS MIH,DEV=dddd,IOTIMING=mm:ss

LOB 表スペースの停止: STOP DATABASE コマンドは LOB 表スペースおよび補助表の索引を停止するために使用できます。LOB 表スペースは、この LOB 表スペースが関連付けられている基本表から独立して停止します。

次の表は、STOP DATABASE コマンドが使用するロックを要約しています。



表 34. STOP DATABASE コマンドが使用するロッキング

コマンド表スペース・タイプ獲得されるロック

STOP AT COMMIT パーティション化 PART IX 大量削除ロック。指定されたパーティションに対する一括ドレーン。

IX 大量削除ロック。すべてのパーティションに対する一括ドレーン。

非パーティション化 IX 大量削除ロック。表スペースに対する一括ドレーン。

STOP パーティション化 PART 指定したパーティションに対する X ロック。指定されたパーティションに対する一括ドレーン。

全パーティションの X ロック。すべてのパーティションに対する一括ドレーン。

非パーティション化表スペース X ロック。表スペースに対する一括ドレーン。

例例 1: データベース DSN8D81A の表スペース DSN8S81E を停止し、この表スペースに属するデータ・セットをクローズします。

-STOP DATABASE(DSN8D81A) SPACENAM(DSN8S81E)

例 2: すべてのデータベース (DSNDB01、DSNDB06、および作業ファイル・データベースを除く) を停止します。

-STOP DATABASE(*)

例 3: すべてのジョブがクレームを解放し、しかもすべてのユーティリティーがドレーン・ロックを解放した時点で、すべてのデータベース (DSNDB01、DSNDB06、および作業ファイル・データベースを除く) を停止します。

-STOP DATABASE(*) AT(COMMIT)

例 4: データベース DSN8D81A のパーティション表スペースの非パーティション索引 (nonpartitioning index)である XEMP2 の先頭パーティションを停止します。パーティション 1 は論理的に停止し、アプリケーションからアクセスできません。しかし、非パーティション索引 (nonpartitioning index)の各部分は個別の物理的データ・セットに関連付けられていないため、クローズされるデータ・セットはありません。

-STOP DATABASE(DSN8D81A) SPACENAM(XEMP2) PART(1)

例 5: データベース DSN8D81A 内の、名前が「T」で始まり、「IQUA03」のストリングで終わる、すべての表スペースを停止します。

-STOP DATABASE(DSN8D81A) SPACENAM(T*IQUA03)

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

DSN9022I - DSNTDDIS ’STOP DATABASE’ NORMAL COMPLETIONDSNT736I - ASYNCHRONOUS STOP DATABASE COMMAND HASCOMPLETED FOR COMMAND: STOP DB(DSN8D81A) SPACE(T*IQUA03)



第 76 章 -STOP DB2 (DB2)

DB2 コマンド STOP DB2 は、DB2 サブシステムを停止します。

省略形: -STO DB2


v 『環境』

v 『許可』

v 『構文』








許可このコマンドを実行するには、次のいずれかの権限または権限を含む処理の特権セットを使用する必要があります。v STOPALL 特権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限


構文

�� STOP DB2QUIESCE

MODE( )FORCE

YESCASTOUT( )

NO

��


#

#########################################

#

オプションの説明MODE現在実行中のプログラムが完了できるかどうかを示します。このオプションの分散スレッドに対する影響については、 433ページの『第 77 章 -STOP DDF

(DB2)』の MODE オプションの説明を参照してください。

(QUIESCE)現在実行中のプログラムが処理を完了することができます。新しいプログラムは開始できません。

(FORCE)ユーティリティーを含め、現在実行中のプログラムを終了します。新しいプログラムは開始できません。MODE(FORCE) は、未確定状態を発生させる原因になる可能性があります。ストアード・プロシージャー・タスクおよびDB2 サービス・タスクなど、一部のタスクは異常終了します。これらのタスクが異常終了した場合、これらの障害のダンプおよびメッセージが出されます。

CASTOUTDB2 メンバーが、このメンバーが最後に更新されたページ・セットまたはパーティションについてキャストアウト処理を行うかどうかを指定します。CASTOUT オプションは、データ共用環境においてのみ適用されます。

YESグループ・バッファー・プールのキャストアウト処理を許可します。

NOグループ・バッファー・プールのキャストアウト処理をスキップします。

使用上の注意MODE(QUIESCE): MODE(QUIESCE) を使用する場合、接続されたすべてのアドレス・スペースは DB2 サブシステムを停止する前にすべての接続を終了しなければなりません。システム・オペレーターは DISPLAY THREAD を使用することにより、残っている接続かあるかどうかを知ることができます。さらに、残っている接続を DB2 CANCEL コマンド、または z/OS コマンドで取り消すこともできます。

MODE(FORCE): 強制的な停止によって、異常終了がすぐに生じるわけではありません。接続されたタスクが DB2 の外で実行中であれば、DB2 は出口ルーチンをポストしてタスクが DB2 にアクセスするのを停止させます。タスクが DB2 で実行している場合には、次の「中断」または「実行単位切り替え」が生じた時点で停止させます。場合によっては、停止する前にかなりの遅延があることがあります。

CASTOUT(NO): DB2 データ共用メンバーを保守目的でシャットダウンする際、CASTOUT(NO) を使用することを検討してみてください。このオプションを使用することにより、データ共用環境でシャットダウン処理を迅速に行えるからです。CASTOUT(NO) を使用してデータ共用グループの複数のメンバーをシャットダウンしようとする場合、メンバーがシャットダウンされた後、グループ・バッファー・プール内に変更データがいくつか存在する場合があります。そこで、ディスク上のデータの一貫性が必要な場合 (例えば、すべてのメンバーをシャットダウンしてオ

-STOP DB2 (DB2)


フサイトに送信するためにデータベースのコピーを作成しようとする場合)、CASTOUT(NO) は使用しないでください。

CASTOUT(NO) を使用すると、DB2 メンバーは QC 状況 (DISPLAY GROUP コマンドにより表示される) でシャットダウンします。この状況は、メンバーが一部のキャストアウト処理が未完了状況で静止していることを示します。最後に更新を行ったのがこの DB2 メンバーであるオブジェクトのそれぞれについて、保持済みのページ・セットまたはパーティションの P ロックは IX 状態で保留されます。また、グループ・バッファー・プールの接続も、永久的障害の状態となります。

例例 1: DB2 サブシステムを停止します。現在アクティブのプログラムを完了させます。新しいプログラムを DB2 に識別させません。

-STOP DB2 MODE (QUIESCE)

例 2: データ共用グループのメンバーを保守目的で停止します。

-STOP DB2 MODE (QUIESCE) CASTOUT(NO)

-STOP DB2 (DB2)

第 76 章 -STOP DB2 (DB2) 431

-STOP DB2 (DB2)


第 77 章 -STOP DDF (DB2)

DB2 コマンド STOP DDF は、分散データ機能 (DDF) がすでに開始されている場合にその機能を停止します。VTAM または TCP/IP との DDF インターフェースを終了するには、このコマンドを使用してください。

省略形: -STO DDF


v 『環境』

v 『許可』

v 『構文』








構文

�� STOP DDFQUIESCE

MODE( )FORCESUSPEND CANCEL(n)

WAIT(n)

��


オプションの説明MODE現在実行中のアクティブ分散スレッドが完了できるかどうかを示します。

(QUIESCE)DDF を使用中のアクティブ分散スレッドは正常に完了させ、アクティブでない分散スレッドのみを終了することができます。DB2 のインストール時に DDF THREADS ACTIVE を指定した場合は、すべての DDF スレッドがアクティブ・スレッドになります。

(FORCE)現在実行中の分散スレッドをすべて終了します。

ストアード・プロシージャー・タスクおよび DB2 サービス・タスクなど、一部のタスクは異常終了します。これらのタスクが異常終了した場合、この障害の結果としてダンプとメッセージが表示される場合があります。

(SUSPEND)以下の方法により、すべての DDF スレッドを中断します。

v 次の START DDF コマンドが発行されるまで、非アクティブ DDF スレッドを非アクティブのまま保持する。

v すべての DDF プール・スレッドを終了する。

v インバウンド DDF 作業の開始を阻止する。

MODE(SUSPEND) は、CREATE、ALTER、DROP、GRANT、またはREVOKE の操作とクライアントのデータ・アクセス間にロック競合が存在する場合に、DB2 DRDA サーバーで使用するためのものです。通常は作業をディスパッチさせる要求 (新しい接続への要求を含む) は、キューに入れられます。アウトバウンド DDF 処理は、このコマンドによる影響はありません。

CANCEL (n)中断処理が n 秒以内に完了しない場合は、すべてのアクティブ DDF

データベース・アクセス・スレッドを取り消します。n の範囲は、0 ～9999 です。

WAIT (n)中断処理が n 秒以内に完了しない場合は、DDF 処理を再開します。n

の範囲は、0 ～ 9999 です。

使用上の注意MODE(QUIESCE): MODE(QUIESCE) を使用する場合、 DDF を停止する前にすべての分散活動を完了する必要があります。オペレーターは LOCATION オプションを指定して DISPLAY THREAD を使用することにより、残っている分散スレッドがあるかどうかを知ることができます。DDF が停止するのを妨げている分散スレッドを取り消すには、CANCEL THREAD について 109ページの『使用上の注意』を参照するか、または STOP DDF MODE(FORCE) を使用してください。

MODE(QUIESCE) を使用すると、非アクティブ・スレッドはいずれも強制的に終了させられます。非アクティブ・スレッドで 2 フェーズ・コミットを使用している要

-STOP DDF (DB2)


求側システムは、STOP DDF を出したシステムにその終了したスレッドを未確定として報告することがあります。そのスレッドは実際には未確定ではなく (保留中のコミットやロールバックがない)、この状態は DDF が再始動すると解決します。

MODE(FORCE): MODE(FORCE) を使用すると、 VTAM または TCP/IP への DB2

接続は終了します。この終了によりすべての VTAM または TCP/IP 要求はただちに強制的に完了し、通信エラーが発生して DDF が停止したことが示されます。強制的な停止は、完了するのに 3 分間かかることがあります。

いずれかのアプリケーションが 2 フェーズ・コミットを使用するリモート・サーバーを更新中の場合、MODE (FORCE) によりそれぞれのサーバーに未確定スレッドが作成される場合があります。

MODE(SUSPEND): MODE(SUSPEND) が正常に完了しても、保留されているデータベース・リソース (このリソースはインバウンド DDF 作業ではありません) がまだ他にある場合があります。 107ページの『第 16 章 -CANCEL THREAD (DB2)』で記載されたとおりに CANCEL THREAD でこれらのリソースを取り消してください。

表 35 では、さまざまな DDF 状態で START DDF、STOP DDF、START DB2、および STOP DB2 が発行された場合に DB2 が取るアクションを要約しています。

表 35. DDF 状況によるコマンドの結果

DDF の状況START DDF

コマンド

MODE(FORCE) 無指定の STOP DB2

または STOP DDF

コマンド

MODE(FORCE) 指定の STOP DB2 またはSTOP DDF コマンド

MODE(SUSPEND) 指定の STOP DDF

コマンド

開始 DSNL003I DSNL003I DSNL003I DSNL003I

開始済み DSNL001I DDF は停止する DDF 強制停止 DDF は中断する

停止中 DSNL005I DSNL005I DSNL005I DSNL005I

停止済み DDF は開始する DSNL002I DSNL002I DSNL002I

中断中 DDF は再開する DDF は停止する DDF 強制停止 DSNL069I

中断される DDF は再開する DDF は停止する DDF 強制停止 DSNL065I

例例 1: 分散データ機能 (MODE QUIESCE) を停止します。

-STOP DDF

例 2: 分散データ機能 (MODE FORCE) を停止します。

-STOP DDF MODE(FORCE)

例 3: 分散データ機能アクティビティーを中断します (MODE SUSPEND)。600 秒後にコマンド処理が継続したとき、残っている DDF スレッドをすべて取り消します。

-STOP DDF MODE(SUSPEND) CANCEL(600)

-STOP DDF (DB2)

第 77 章 -STOP DDF (DB2) 435

第 78 章 -STOP FUNCTION SPECIFIC (DB2)

DB2 コマンド STOP FUNCTION SPECIFIC は、指定された関数が呼び出されると、 DB2 が SQL ステートメントを受け付けないようにします。このコマンドは、SQL ステートメントのうち、DB2 によってすでにキューに入れられたりスケジュールされたものについては、関数の呼び出しによって実行を妨げることはありません。別の関数にソースがある組み込み関数またはユーザー定義関数は、このコマンドで停止することはできません。

DB2 は最大異常終了カウントを超えたすべての関数に対し、暗黙にコマンド STOP

FUNCTION SPECIFIC ACTION(REJECT) を出します。このカウントは、インストール・パネル DSNTIPX の MAX ABEND COUNT フィールドで設定します。

省略形: -STO FUNC SPEC


v 『環境』

v 『許可』







許可このコマンドを実行するには、各機能に対して次の権限のいずれかを含む処理の特権セットを使用する必要があります。v 関数の所有権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限

STOP FUNCTION SPECIFIC *.* または schema.partial-name* を指定する場合、処理の特権セットに次の権限のいずれかを含める必要があります。v SYSOPR 権限v SYSCTRL 権限


|

|

v SYSADM 権限


構文

�� STOP FUNCTION SPECIFIC

�

(*.*)

,


�

�QUEUE

ACTION ( REJECT )LOCAL

SCOPE ( GROUP )

��

オプションの説明(*.*)すべての関数へのアクセスを、 DB2 アプリケーションがまだアクセスしていない関数も含めて、停止します。

関数の名前を指定しないと、すべての関数を停止します。

schema.specific-function-name

1 つの特定の関数名を停止します。SQL で指定できるような形式で関数名を指定することはできず、特定名を使用しなければなりません。CREATE

FUNCTION ステートメントで特定の名前を指定しなかった場合は、SYSIBM.SYSROUTINES を照会して正しい特定名を調べてください。



schema.partial-name*指定されたスキーマ内の関数のセットを停止します。セット内のすべての関数の特定名は、partial-name で始まり、任意のストリング (空白ストリングを含む)

で終わることができます。例えば schema1.ABC* は、 schema1 内の ABC で始まる特定名を持つ、すべての関数を停止します。

ACTION関数が停止されている間、関数を呼び出す SQL ステートメントをどうするかを示します。STOP FUNCTION SPECIFIC が特定の関数について 2 回以上出された場合にとられる処置は、最後のコマンドの ACTION オプションによって決まります。

-STOP FUNCTION SPECIFIC


|

|||||||||||||||||||||||||||||||

||||||||||||||||||||||||||||||||||||||||||

|

(QUEUE)次のいずれかの条件が成立するまで、要求をキューに入れます。

v 待ち時間がインストール時のタイムアウト値を超えた。

v 関数に対して START FUNCTION SPECIFIC コマンドが出された。

(REJECT)要求をリジェクトします。


(LOCAL)ローカル・メンバーの機能のみを停止することを指定します。

(GROUP)データ共用グループのすべてのメンバーの機能を停止することを指定します。

使用上の注意STOP FUNCTION SPECIFIC の制約事項: STOP FUNCTION SPECIFIC は、WLM アプリケーション環境で実行される外部関数にのみ適用されます。STOP

FUNCTION SPECIFIC は、別の関数にソースがある組み込み関数またはユーザー定義関数を停止することはできません。

関数を永続的に使用不可にする: 停止している関数は、DB2 が停止して、再び始動すると、停止状態ではなくなります。関数を永続的に使用不可にするには、次のようにします。

v ALTER FUNCTION を使用して、LOADMOD 名を存在しない z/OS ロード・モジュールに変更する

v その z/OS ロード・モジュールを名前変更または削除する

例例 1: すべての関数へのアクセスを停止します。STOP FUNCTION SPECIFIC コマンドが有効な間、DB2 は関数を実行しようとするすべての試みをキューに入れます。

-STOP FUNCTION SPECIFIC ACTION(QUEUE)


DSN9022I - DSNX9COM ’-STOP FUNC’ NORMAL COMPLETION

例 2: すべての関数へのアクセスを停止します。STOP FUNCTION SPECIFIC コマンドが有効な間、DB2 は関数を実行しようとする試みをリジェクトします。

-STOP FUNCTION SPECIFIC ACTION(REJECT)




第 78 章 -STOP FUNCTION SPECIFIC (DB2) 439

|

|

|

|

|

|

|

例 3: 関数 PAYROLL.USERFN1 と PAYROLL.USERFN3 を停止します。STOP

FUNCTION SPECIFIC コマンドが有効な間、DB2 は関数を実行しようとするすべての試みをキューに入れます。

-STOP FUNCTION SPECIFIC(PAYROLL.USERFN1,PAYROLL.USERFN3)



例 4: 関数 PAYROLL.USERFN1 と PAYROLL.USERFN3 を停止します。STOP

FUNCTION SPECIFIC コマンドが有効な間、DB2 はこのいずれかの関数を実行しようとする試みをリジェクトします。

-STOP FUNCTION SPECIFIC(PAYROLL.USERFN1,PAYROLL.USERFN3) ACTION(REJECT)





第 79 章 STOP irlmproc (z/OS IRLM)

STOP irlmproc コマンドは、IRLM を正常にシャットダウンします。現在 IRLM に識別されるアクティブ DB2 サブシステムがある場合、このコマンドはリジェクトされます。

省略形: P


v 『環境』

v 『許可』

v 『構文』







構文

�� STOP irlmproc ��


停止する IRLM のプロシージャー名を識別します。


使用上の注意IRLM の終了: IRLM が正常にシャットダウンしない場合、MODIFY

irlmproc,ABEND コマンドを発行して IRLM を異常終了させてください。未解決のDB2 要求が処理中であり、IRLM が終了しない場合は、z/OS CANCEL コマンドを使用してください。サブシステムを除去するための他のすべての手段が失敗した場合は、z/OS FORCE CANCEL コマンドを出してください。

F irlmproc,ABEND,DUMP

例システム・コンソールで次のコマンドを入力します。

P KRLM1

IRLM は、システム・コンソールに以下の応答を出力します。

DXR165I IR21 TERMINATED VIA IRLM MODIFY COMMANDDXR121I IR21 END-OF-TASK CLEANUP SUCCESSFUL - HI-CSA 325K

データ共用環境において: DB2 サブシステムが IRLM に識別されなくなり、IRLM

から以下のメッセージが出るまで、データ共用グループの IRLM に対して STOP

irlmproc コマンドを出すことはできません。

DXR136I IR21 HAS DISCONNECTED FROM THE DATA SHARING GROUP

グループ内でまだアクティブなメンバーは、次のメッセージを出します。

DXR137I JR21 GROUP STATUS CHANGED. IR21 233 HAS BEEN DISCONNECTEDFROM THE DATA SHARING GROUP

STOP irlmproc (z/OS IRLM)


第 80 章 -STOP PROCEDURE (DB2)

DB2 コマンド STOP PROCEDURE は、DB2 が 1 つ以上のストアード・プロシージャーの SQL CALL ステートメントを受け入れないようにします。ストアード・プロシージャー名は、スキーマ名を付けて修飾することができます。CALL ステートメントのうち、DB2 によってすでにキューに入れられたりスケジュールされたものについては、このコマンドは実行を妨げません。

DB2 が設定したストアード・プロシージャーのアドレス・スペースが DB2 に接続されている場合、z/OS は STOP PROCEDURE コマンドの構文に基づいて、これを停止します。

DB2 は最大異常終了カウントを超えたすべてのストアード・プロシージャーに対し、暗黙にコマンド STOP PROCEDURE ACTION(REJECT) を出します。このカウントは、インストール・パネル DSNTIPX の MAX ABEND COUNT フィールドで設定します。

省略形: -STO PROC


v 『環境』

v 『許可』







許可このコマンドを実行するには、次の権限のいずれかを含む処理の特権セットを使用する必要があります。v ストアード・プロシージャーの所有権v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限


|

|

STOP PROCEDURE *.* または schema.partial-name* を指定する場合、処理の特権セットに、次の権限のいずれかを含める必要があります。v SYSOPR 権限v SYSCTRL 権限v SYSADM 権限


構文

�� STOP PROCEDURE

�

(*.*)

,


�

�QUEUE

ACTION ( REJECT )LOCAL

SCOPE ( GROUP )

��

オプションの説明(*.*)すべてのストアード・プロシージャーに対するアクセスをすべてのスキーマ内で停止します。これには、DB2 アプリケーションがまだアクセスしていなかったプロシージャー定義も含まれます。DB2 が確立したストアード・プロシージャーのアドレス・スペースは、アクティブの作業が完了してから終了します。

(schema.procedure-name)停止するプロシージャーの完全修飾名を指定します。

(schema.partial-name*)指定されたスキーマ内のストアード・プロシージャーのセットを停止します。このセット内のすべてのプロシージャーの名前は partial-name で始まり、任意のストリング (空白ストリングを含む) で終わることができます。例えばPAYROLL.* は、 PAYROLL スキーマ内のすべてのストアード・プロシージャーを停止します。

procedure-name

停止しようとする 1 つ以上のストアード・プロシージャー名を特定して指定します。このプロシージャー名は SYSPROC スキーマ名を付けて暗黙に修飾されています。

partial-name*SYSPROC スキーマ内のストアード・プロシージャーのセットを停止します。こ

-STOP PROCEDURE (DB2)


|

|||||||||||||||||||||||||||||||||||||

||||||||||||||||||||||||||||||||||||||||||

|

のセット内のすべてのプロシージャーの名前は partial-name で始まり、任意のストリング (空白ストリングを含む) で終わることができます。例えば、ABC*

を指定すると ABC で始まる名前をもつすべてのストアード・プロシージャーが停止します。

ACTIONプロシージャーが停止している間に受け取った CALL ステートメントをどのように処置するかを示します。STOP PROCEDURE が特定のプロシージャーについて 2 回以上出された場合にとられる処置は、最後のコマンドの ACTION オプションによって決定されます。

(QUEUE)次のいずれかが生じるまで、要求をキューに入れます。

v 待機時間がインストール時のタイムアウト値を超えた。

v ストアード・プロシージャーがコマンド START PROCEDURE により開始した。

(REJECT)要求をリジェクトします。


(LOCAL)ローカル・メンバーのプロシージャーについてのみ停止することを指定します。

(GROUP)データ共用グループのすべてのメンバーのプロシージャーを停止することを指定します。

使用上の注意ストアード・プロシージャーを永続的に使用不可にする: 停止しているプロシージャーは、DB2 が停止して、再び始動すると、停止状態ではなくなります。ストアード・プロシージャーを永続的に使用不可にするには、次のような方法があります。

v DROP PROCEDURE ステートメントを使用してプロシージャーを除去する。詳しくは、「DB2 SQL 解説書」第 5 章を参照してください。

v ALTER PROCEDURE ステートメントを使用する

v その z/OS ロード・モジュールを名前変更または削除する

ストアード・プロシージャーのアドレス・スペース管理の相違: STOP PROCEDURE

コマンドは、DB2 ストアード・プロシージャーのアドレス・スペースがどのように設定されているかにより働き方が異なります。詳しくは、「DB2 管理ガイド」第 4



第 80 章 -STOP PROCEDURE (DB2) 445

|

|

|

|

|

|

|

|

例例 1: すべてのストアード・プロシージャーへのアクセスを停止させ、 DB2 ストアード・プロシージャーのアドレス・スペースを終了させます。STOP PROCEDURE

コマンドが有効である間は、ストアード・プロシージャーを実行する試みはキューに入れられます。

-STOP PROCEDURE ACTION(QUEUE)

DSNX947I - DSNX9SP2 STOP PROCEDURE SUCCESSFUL FOR *.*DSN9022I - DSNX9COM ’-STOP PROC’ NORMAL COMPLETION

例 2: すべてのストアード・プロシージャーへのアクセスを停止させ、 DB2 ストアード・プロシージャーのアドレス・スペースを終了させます。STOP PROCEDURE

コマンドが有効である間は、ストアード・プロシージャーを実行する試みはリジェクトされます。

-STOP PROCEDURE ACTION(REJECT)

DSNX947I - DSNX9SP2 STOP PROCEDURE SUCCESSFUL FOR *.*DSN9022I - DSNX9COM ’-STOP PROC’ NORMAL COMPLETION

例 3: ストアード・プロシージャー USERPRC1 および USERPRC3 を停止させます。STOP PROCEDURE コマンドが有効である間は、これらのストアード・プロシージャーを実行する試みはキューに入れられます。

-STOP PROCEDURE(USERPRC1,USERPRC3)

DSNX947I - DSNX9SP2 STOP PROCEDURE SUCCESSFUL FOR USERPRC1DSNX947I - DSNX9SP2 STOP PROCEDURE SUCCESSFUL FOR USERPRC3DSN9022I - DSNX9COM ’-STOP PROC’ NORMAL COMPLETION

例 4: ストアード・プロシージャー USERPRC1 および USERPRC3 を停止させます。STOP PROCEDURE コマンドが有効である間は、これらのストアード・プロシージャーを実行する試みはリジェクトされます。

-STOP PROCEDURE(USERPRC1,USERPRC3) ACTION(REJECT)

DSNX947I - DSNX9SP2 STOP PROCEDURE SUCCESSFUL FOR USERPRC1DSNX947I - DSNX9SP2 STOP PROCEDURE SUCCESSFUL FOR USERPRC3DSN9022I - DSNX9COM ’-STOP PROC’ NORMAL COMPLETION



第 81 章 -STOP RLIMIT (DB2)

DB2 コマンド STOP RLIMIT は、リソース限定機能を停止します。STOP RLIMIT

は、以前に設定された制限をすべて無限大にリセットし、累算された時間をゼロにリセットします。前に制限され、SQL PREPARE または EXECUTE IMMEDIATE

ステートメントによって実行された SQL ステートメント (SELECT、UPDATE、DELETE、および INSERT) は、制限なしで実行します。

省略形: -STO RLIM


v 『環境』

v 『許可』

v 『構文』






構文

�� STOP RLIMIT ��


例リソース限定機能を停止します。

-STOP RLIMIT

-STOP RLIMIT (DB2)


第 82 章 -STOP TRACE (DB2)

DB2 コマンド STOP TRACE は、トレースを停止します。

このコマンドには 1 つの追加オプションがあり、他の一部のオプションには追加の値があります。この追加情報は、IBM ソフトウェア・サポートの指示のもとで保守し、使用するようになっています。詳しくは、「DB2 Diagnosis Guide and

Reference」を参照してください。

省略形: -STO TRA


v 『環境』

v 『許可』












|

|

構文

�� STOP TRACE ( PERFM )ACCTGSTATAUDITMONITOR*

destination block constraint block�

�COMMENT(string) LOCAL

SCOPE( GROUP )

��

destination block:

��

,

DEST( )GTFSMFSRVOPn

��

constraint block:

��

*,


*,

AUTHID( authorization-id ) �

� �

*,


*,

TNO( integer )

�

LOCATION( * ),

location-name<luname>ipaddr

��

オプションの説明以下のそれぞれのトレース・タイプの詳しい説明については、 407ページの『第 73

章 -START TRACE (DB2)』を参照してください。

(PERFM)パフォーマンスの分析とチューニングを目的とするトレースを停止することを指定します。

省略形: P

-STOP TRACE (DB2)


|

|||||||||||||||||||||||||||||||||||||||||

|||||||||||||||||||||||||||||

|

(ACCTG)アカウンティング・トレースを停止することを指定します。

省略形: A

(STAT)統計データを収集するトレースを停止することを指定します。統計トレースを選択する場合、LOCATION オプションは指定できません。

省略形: S

(AUDIT)DB2 の各種コンポーネントから監査データを収集するトレースを停止することを指定します。

省略形: AU

(MONITOR)モニター・データを収集するトレースを停止することを指定します。

省略形: MON

(*) すべてのトレース・アクティビティーを停止することを指定します。モニター・トレース・クラス 6 を使用するトレースを指定して STOP TRACE (*) を使用する操作については、 453ページの『使用上の注意』を参照してください。


(LOCAL)ローカル DB2 サブシステムのトレースのみを停止します。

(GROUP)データ共用グループのすべてのメンバー上のトレースを停止します。

COMMENT(string)STOP TRACE コマンドのトレース出力レコード (常駐のトレース表を除く) で複製されるコメントを指定します。

string は任意の SQL ストリングで、中にブランク、コンマ、または特殊文字が含まれる場合はアポストロフィで囲む必要があります。

DEST停止を、特定の宛先について開始されたトレースに限定します。複数の値を使用できますが、同じ値を 2 回使用してはなりません。DEST に値を指定しない場合、DB2 は停止するトレースを制限するにあたって宛先を使用しません。

省略形: D

指定可能な値とその意味は以下のとおりです。

値トレースの宛先GTF 汎用トレース機能SMF システム管理機能SRV ユーザー作成ルーチンへの出口OPn 特定の宛先。 n には値として 1 ～ 8 が指定可能です。

トレース・タイプごとの指定可能な宛先については、 407ページの『第 73 章-START TRACE (DB2)』のリストを参照してください。

-STOP TRACE (DB2)

第 82 章 -STOP TRACE (DB2) 451

|

|

|

|

|

|

PLAN(plan-name, ...)停止を、特定のアプリケーション・プランについて開始されたトレースに限定します。プラン名は 8 つまで使用できます。複数の名前を使用する場合、AUTHID、TNO、および LOCATION に使用できる値は 1 つだけです。このオプションは、STAT と同時に使用しないでください。

デフォルトは PLAN(*) で、コマンドへの制限はありません。

AUTHID(authorization-id, ...)停止を、特定の許可 ID について開始されたトレースに限定します。ID は 8

つまで使用できます。複数の ID を使用する場合、PLAN、TNO、およびLOCATION に使用できる値は 1 つだけです。このオプションは、STAT と同時に使用しないでください。

デフォルトは AUTHID(*) で、コマンドを制限しません。

CLASS(integer, ...)停止を、特定のクラスについて開始されたトレースに限定します。指定可能なクラスの説明については、 407ページの『第 73 章 -START TRACE (DB2)』を参照してください。トレース・タイプを指定しなかった場合は、クラスを指定できません。

省略形: C

デフォルトは CLASS(*) で、コマンドへの制限はありません。

TNO(integer, ...)停止を、トレース番号 (1 ～ 32、01 ～ 09) によって識別された特定のトレースに限定します。トレース番号は 8 つまで使用できます。複数の番号を使用する場合、PLAN、AUTHID、および LOCATION に使用できる値はそれぞれ 1

つだけです。

デフォルトは TNO(*) で、コマンドを制限しません。

LOCATION(location-name, ...)トレースが停止される特定のロケーション名のリストを指定します。停止できるトレースを、リモート・ロケーションへの接続をもつスレッドについて開始されたトレースに限定します。なお、LOCATION オプションを使用すると非分散スレッドのトレースは停止しなくなります。

ロケーション名は 8 つまで指定することができます。複数のロケーション名を使用する場合、PLAN、AUTHID、および TNO に使用できる値は 1 つだけです。このオプションは、STAT と同時には使用できません。

デフォルトは LOCATION( ) で、コマンドを制限しません。

(*) このコマンドで LOCATION(*) が限定しているトレース対象は、START

TRACE の LOCATION キーワードに指定した 1 つ以上のロケーション名を使って開始したトレースです。

<luname><luname> に指定するリモート SNA LU を介して DDF に接続しているリモート・クライアントに対して DB2 トレースを停止します。

-STOP TRACE (DB2)


ipaddr

リモート TCP/IP ホストを介して DDF に接続しているリモート・クライアントについての DB2 トレースを停止します。nnn.nnn.nnn.nnn はドット表記の 10 進数の IP アドレスです。

DB2 UDB for z/OS 以外のリクエスター : DB2 は、DB2 以外のリクエスターからロケーション名を受け取りません。DB2 UDB for z/OS サブシステムではないリクエスターについての情報を表示するには、そのリクエスターのLUNAME をより小 (<) とより大 (>) 記号で囲んで入力します。例えば、LULA

の LUNAME を持つリクエスターについての情報を表示させるには、次のコマンドを入力してください。

-STOP TRACE (*) LOCATION (<LULA>)

DB2 では、DB2 UDB for z/OS 以外のリクエスターの情報を表示するメッセージ内で、<LUNAME> という表記が使用されます。

使用上の注意特定のトレースの停止: 使用する各オプション (TNO を除く) は、まったく同じパラメーター値を指定した同一のオプション (明示的またはデフォルトのいずれでも)

で開始されたアクティブ・トレースに限定されます。例えば、次のコマンドでは、オプション PERFM および CLASS (1,2) を使用して開始されたアクティブ・トレースのみが停止します。

-STOP TRACE (PERFM) CLASS (1,2)

このコマンドは、例えば、CLASS (1) を使用して開始されたトレースを停止しません。

トレース・タイプ、あるいはアスタリスクを指定する必要があります。例えば、次のコマンドはすべてのアクティブ・トレースを停止します。

-STOP TRACE (*)

モニター・トレース・クラス 6 を使用するトレース: トレース・クラスを停止すると、モニター・トレース・クラス 6 がアクティブである場合には特殊な状況が生じます。モニター・トレース・クラス 6 は、データ伝搬を使用可能にしたり使用不可にしたりします。間違ってこのトレース・クラスを停止しないようにするために、モニター・トレース・クラス 6 がアクティブである場合にはコマンド STOP

TRACE(*) と STOP TRACE(MON) CLASS(*) が失敗します。

モニター・トレース・クラス 6 を停止させるには、STOP TRACE コマンドのCLASS オプションの引数の 1 つとして明示的にクラス 6 を指定すると共に、モニター・トレース・クラス 6 で開始した他のトレース・クラスも指定しなければなりません。例えば、モニター・トレース・クラス 6 がコマンド START

TRACE(MON) CLASS(1,3,6) で開始した場合には、次のコマンドでそれを停止させます。

-STOP TRACE(MON) CLASS(1,3,6)

モニター・トレース・クラス 6 がコマンド START TRACE(MON) CLASS(*) で開始した場合には、モニター・トレース・クラス 6 を停止させるには、32 あるすべてのモニター・トレース・クラスを明示的に指定することが必要になります。

-STOP TRACE (DB2)

第 82 章 -STOP TRACE (DB2) 453

-STOP TRACE(MON) CLASS(1,2,3,4,5,6,...32)

ただし、モニター・トレース・クラス 6 がアクティブでない場合は、STOP

TRACE(*) コマンドですべてのアクティブ・トレースは停止します。

IFI/IFC プログラムによって開始したトレース: アクティブなトレースを停止する前に、IFI アプリケーション・プログラムまたは IFC Selective Dump ユーティリティー (DSN1SDMP) がトレースを開始していることがないようにしてください。DSN1SDMP により開始されたトレースを停止すると、 DSN1SDMP ユーティリティーは異常終了します。

例例 1: 汎用トレース機能をその唯一の宛先として持つ、すべてのトレースを停止します。

-STOP TRACE (*) DEST (GTF)

例 2: プラン DSN8BC81 について、ローカルと USIBMSTODB21 DB2 サブシステム間のすべてのスレッドのアカウンティング・トレースを停止します。これはコメントも含んでいます。

-STOP TRACE (ACCTG)PLAN (DSN8BC81)LOCATION (USIBMSTODB21)COMMENT(’ACCTG TRACE FOR DSN8BC81’)

例 3: トレース番号 4 を停止します。

-STOP TRACE (P) TNO(4)

例 4: USIBMSTODB22 について、すべてのタイプのすべてのアクティブのトレースを停止します。

-STOP TRACE (*) LOCATION (USIBMSTODB22)

例 5: すべてのパフォーマンス・トレースを停止します。

-STOP TRACE=P

例 6: すべてのモニター・トレースを停止します。

-STOP TRACE(MON)

例 7: データ共用グループ内のすべてのモニター・トレースを停止します。

-STOP TRACE(MON) SCOPE(GROUP)

-STOP TRACE (DB2)


|

|

第 83 章 -TERM UTILITY (DB2)

DB2 コマンド TERM UTILITY は、DB2 ユーティリティー・ジョブ・ステップの実行を終了させ、そのステップに関連したすべてのリソースを解放します。実行中のユーティリティーは、TERM UTILITY コマンドが発行されたことをチェックして分かるまで終了しません。アクティブ・ユーティリティーはこの検査を、定期的に行います。ユーティリティーが停止すると、そのリソースは TERM UTILITY コマンドによってすべて解放されます。アクティブなユーティリティーは、それが実行されている DB2 からのみ終了させることができます。停止したユーティリティーは、データ共用グループの任意のアクティブなメンバーから終了させることができます。

省略形: -TER UTIL


v 『環境』

v 『許可』





環境このコマンドの入力は、z/OS コンソール、DSN セッション、DB2I パネル DB2

COMMANDS と DB2 UTILITIES、IMS または CICS 端末、または計測機能インターフェース (IFI) を使用するプログラムから行うことができます。

データ共用範囲: グループまたはメンバー。ユーティリティーは、ユーティリティーが停止しているときは、暗黙にグループの範囲になります。リリース依存情報については、「DB2 データ共用: 計画および管理」を参照してください。

許可このコマンドを実行するには、最初にユーティリティー・ジョブをサブミットしたプロセスの 1 次または 2 次許可 ID を使用するか、または以下のいずれかの権限を含むプロセスの特権セットを使用する必要があります。

v DBMAINT 権限

v DBCTRL 権限

v DBADM 権限

v SYSOPR 権限

v SYSCTRL 権限

v SYSADM 権限


ユーティリティー DIAGNOSE、REPORT、および STOSPACE は、ジョブ・サブミッター、または SYSOPR、SYSCTRL、または SYSADM 権限の所有者のみが終了できます。


DBMAINT、DBCTRL、または DBADM 権限を持つユーザーの場合、このコマンドが有効となるのは、ユーティリティー・ジョブがアクセスする各オブジェクトに対してユーザーが十分の特権を有していることを DB2 が判別できる場合に限られます。

データベース DSNDB06 に含まれる表スペースと索引スペースは、許可を検査する必要があります。許可検査に必要な表または索引スペースが、終了の必要があるユーティリティーによる影響を受ける場合は、そのユーティリティーを終了するのに、インストール SYSADM 権限が必要です。

構文

�� TERM UTILITY ( utility-id )partial-utility-id**

��

オプションの説明以下のいずれかのパラメーターが指定されている必要があります。

(utility-id)これはユーティリティー ID です。あるいは、ユーティリティー・ジョブ・ステップの作成時に使用した UID パラメーターです。

utility-id がデフォルトの DSNU CLIST によって作成された場合の形式は、tso-userid.control-file-name となります。各ユーティリティーに関連した制御ファイル名については、「DB2 ユーティリティー・ガイドおよび解説書」にあるDSNU ユーティリティーの説明を参照してください。

utility-id がデフォルトにより、DSNUTILB を呼び出す EXEC ステートメントによって作成された場合、そのトークンの形式は userid.jobname となります。

小文字の utility-id の場合、名前全体をアポストロフィで囲みます。例えば、’SMITH’ と指定します。

(partial-utility-id*)partial-utility-id で始まるユーティリティー・ジョブをすべて終了させます。例えば、TERM UTILITY(ABCD*) を使用すると、ユーティリティー ID が ABCD

という文字で始まるあらゆるユーティリティー・ジョブ・ステップが終了します。ユーティリティー ID が ABCD.EFGH のように 2 つの部分からなる場合、TERM UTILITY(ABCD*) の指定でそのユーティリティーも終了させます。

-TERM UTILITY (DB2)


(*) DB2 が認識しているユーティリティー・ジョブ・ステップで、ユーザーが許可されているものをすべて終了します。

使用上の注意ユーティリティーの再始動: 終了したユーティリティー・ジョブ・ステップは再始動できません。そのステップは新しいユーティリティー・ジョブとして再び実行依頼する必要があります。

特定のユーティリティーにおける結果: 場合によっては、ユーティリティー・ジョブを終了した結果、作業が好ましくない状態のままになり、特別な処理を行わなければジョブを再実行依頼できないことがあります。次のリストは、各ユーティリティー別ジョブに対して、TERM UTILITY の影響を説明しています。

ユーティリティー TERM UTILITY コマンドの特殊な影響

CATENFM なし。

CATMAINT 索引を REBUILD ペンディング状況にします。

CHECK DATA 表スペースは、CHECK ペンディング状況にとどまります。

CHECK INDEX なし。

CHECK LOB LOB 表スペースと索引をユーティリティー読み取り専用 (UTRO) 状態にします。

COPY SYSIBM.SYSCOPY に「T」レコードを挿入します。COPY の実行時に「T」レコードが存在していると、COPY で増分イメージ・コピーを行うことはできません。

DIAGNOSE なし。

LOAD LOAD ユーティリティー・フェーズに対するTERM の影響については、「DB2 ユーティリティー・ガイドおよび解説書」を参照してください。

MERGECOPY なし。

MODIFY RECOVERY なし。

MODIFY STATISTICS なし。

QUIESCE なし。

REBUILD INDEX 再作成中のオブジェクトを REBUILD ペンディング状況にします。

RECOVER リカバリー中のオブジェクトを RECOVER ペンディング状況にします。

REORG INDEX REORG INDEX ユーティリティー・フェーズに対する TERM の影響については、「DB2 ユーティリティー・ガイドおよび解説書」を参照してください。

REORG TABLESPACE REORG TABLESPACE ユーティリティー・フェー

-TERM UTILITY (DB2)

第 83 章 -TERM UTILITY (DB2) 457

ズに対する TERM の影響については、「DB2 ユーティリティー・ガイドおよび解説書」を参照してください。

REPAIR なし。

REPORT なし。

RUNSTATS なし。

STOSPACE なし。

UNLOAD 出力データ・セットは、ユーティリティー・ジョブを再始動するか、またはそのデータ・セットを削除するまで、未完了の状態となります。

例例 1: 許可を受けているユーティリティー・ジョブをすべて終了します。

-TERM UTILITY (*)

例 2: ユーティリティー ID が SMITH で始まるユーティリティー・ジョブを、すべて終了します。

-TERM UTILITY(SMITH*)

例 3: ユーティリティー ID が小文字のユーティリティー・ジョブを終了します。

-TERM UTILITY(’SMITH’)

-TERM UTILITY (DB2)


#

##

第 84 章 /TRACE (IMS)

IMS /TRACE コマンドは、内部 IMS イベントのトレースを行う IMS 機能を指示し、制御するときに使用します。また、IMS モニターによってモニターされる活動の開始、停止、および定義も行います。 IMS モニターの詳細については、「IMS

ユーティリティー解説書: システム」を参照してください。

省略形: /TRA


v 『環境』

v 『許可』

v 『構文』





許可このコマンドを入力するには IMS セキュリティー検査にパスする必要があり、これについては「IMS 管理の手引き: システム」で説明しています。

次の構文図には、DB2 ユーザーが知っている必要のあるパラメーターだけが記載されています。このコマンドの完全な構文を示す構文図は、「IMS コマンド解説書」を参照してください。

構文

�� /TRACE SET ONOFF ALL

TABLE SUBSNOLOG

OPTION LOG

��

オプションの説明/TRACE コマンドのオプションについては「IMS コマンド解説書」で説明しています。ただし、このセクションでのでは、DB2 ユーザーにとって特に重要な 2 つのパラメーター情報を取り上げます。


SUBS外部サブシステム・トレース・テーブル (DB2 とのあらゆる対話に関する情報が入っている) を使用可能にするか、または使用不可にするかを示します。SET

ON TABLE SUBS ならば DB2 トレース機能は使用可能になり、SET OFF

TABLE SUBS の場合は使用不可になります。

TABLE キーワードに何も指定しない場合のデフォルトは ALL です。ALL には、他のトレース・テーブルとともに SUBS も含まれます。

LOGトレースしたデータを IMS システム・ログに書き込むことを指定します。IMS

にはトレース項目を IMS システム・ログへ書き込むトレース・メカニズムがあるため、DB2 ユーザーは SET ON および TABLE OPTION LOG を指定することが重要です。指定しなかった場合は、制御領域ダンプが起きない限り、IMS

が提供するトレース情報を使用することはできません。

例例 1: このコマンドは IMS トレースを開始して、さらに次のことも行います。

v DB2 トレースを使用可能にする

v IMS トレース・テーブルが循環する前に、それを IMS ログへ書き込む

/TRACE SET ON TABLE SUBS OPTION LOG

例 2: このコマンドは IMS トレースを開始してさらに次のことも行います。

v すべてのトレース・テーブル (DB2 トレース表を含む) を使用可能にする。(ALL

が TABLE キーワードのデフォルト・パラメーターです)

v IMS トレース・テーブルが循環する前に、それを IMS ログへ書き込む

/TRACE SET ON TABLE ALL OPTION LOG

/TRACE (IMS)


第 85 章 TRACE CT (z/OS IRLM)

z/OS コマンド TRACE CT は、DB2 の内部リソース・ロック管理プログラム(IRLM) に対する診断トレースを開始、停止、または修正します。IRLM は、「z/OS

MVS システム・コマンド」で説明されている TRACE コマンドで使用可能なオプションをすべてサポートしているわけではありません。


v 『環境』

v 『許可』

v 『構文』






このコマンドの構文図とオプションの説明は、意図的に不完全なものにしてあります。示されていないオプションについては、「z/OS MVS システム・コマンド」で説明しています。

構文

�� TRACE CT,,WRAP

WTRSTART=parmlibmem,NOWRAP

WTRSTOP=jobnameON, COMP=irlmssnm

,SUB=( DBM )EXPINTSLMXCFXIT

OFF

��


オプションの説明CTコンポーネント・トレースを指定します。(z/OS TRACE コマンドで利用可能な他のトレース・オプションを使用しないでください。)

WTRSTART=parmlibmem

ソース JCL をもつメンバーを識別します。この JCL は CTRACE 書き込み機能を実行し、トレース・バッファーの書き込み先となるデータ・セットを定義します。このメンバーは、SYS1.PROCLIB 内にカタログされたプロシージャーであることも、ジョブであることもあります。

WRAPシステムがデータ・セットのグループの終わりに達したときに、そのグループ内の最初のデータ・セットのはじめの部分にある一番古いデータを上書きすることを指定します。システムは、データ・セットの 1 次エクステントだけを使用します。

NOWRAPデータ・セットがいっぱいになったらシステムがそのデータ・セットに対する書き込みを停止するよう指定します。システムは、データ・セットの 1 次および 2 次エクステントを使用します。

WTRSTOP=jobname

実行中のトレースに対する CTRACE 書き込み機能を停止します。さらに、システムはその書き込み機能が使用したデータ・セットをクローズします。

jobname は以下のいずれかによってトレースを識別します。v メンバー名。ソース JCL がプロシージャーである場合。v ジョブ名。これがソース JCL 内の JOB ステートメントに現れる場合。

ONトレースをオンにします。

COMP=irlmssnm

IRLM サブシステム名を指定します。

SUB=subname

サブレベル・トレースのタイプを指定します。トレース INT、EXP、および XIT のデフォルトは ON です。トレース INT とEXP をオフにすることはできません。TRACE コマンドに subname

を指定しないと、制御するすべてのサブネームについてトレースが実行されます。1 つのサブネームを指定すると、トレースが限定されて、そのサブネームのトレースと、EXP および INT トレースになります。

次のオプションを使用します。トレースの対象

DBM 識別された DBMS との対話EXP 任意の例外条件INT 通常のロッキング活動の範囲外にあるメンバーおよびグルー

プのイベントSLM z/OS ロッキング・コンポーネントとの対話XCF z/OS システム間結合サービスとのすべての対話

TRACE CT (z/OS IRLM)


XIT z/OS ロッキング・コンポーネントとの非同期対話のみ

OFFトレースをオフにします。IRLM がコンポーネント・トレースに対するCTRACE 書き込み機能に接続されている場合、システムはそれを切断します。

使用上の注意IRLM ロード・モジュールを z/OS リンク・リストに組み込む: このコマンドはz/OS コンポーネント・トレース・サービスを使用します。停止と開始のためのルーチンが含まれている IRLM ロード・モジュール DXRRL183 を z/OS リンク・リストに組み込みます。

トレースの表示: トレースを表示するには、次のような z/OS DISPLAY コマンドを使用します。

D TRACE,COMP=IRLM

z/OS DISPLAY TRACE コマンドの出力は、TRACE CT コマンドを使用して z/OS

に TRACE 状況を通知しない限り、IRLM にとっては正しくありません。IRLM は独自のトレースを初期化し、CTRACE フォーマットで書き込みますが、IRLM はz/OS に状況を通知するためのインターフェースを備えていません。z/OS に通知するために、TRACE CT コマンドを使用せずにトレースの真の状況を知りたい場合は、MODIFY irlmproc,STATUS,TRACE コマンドを使用してください。

トレースのモニター: トレースをモニターするには、313 ページの z/OS MODIFY

irlmproc,STATUS,TRACE コマンドを使用します。

トレース・バッファー数の設定: トレースが使用するトレース・バッファー数を設定するには 307 ページの z/OS MODIFY irlmproc,SET コマンドを使用します。

CTRACE 書き込み機能のプロシージャーの例: このプロシージャーは、次のサンプル・プロシージャーがデータを書き込むデータ・セットを識別します。外部トレース書き出しプログラムは、IRLM 以上のディスパッチ優先順位で実行する必要があります。これにより、I/O がトレース・バッファーの充てんに対応できるようになります。

//CTWTR PROC// EXEC PGM=ITTTRCWR//TRCOUT01 DD DSNAME=SYS1.WTR1,DISP=OLD//TRCOUT02 DD DSNAME=SYS1.WTR2,DISP=OLD

CTRACE 書き込み機能への DBM トレースを開始および停止するプロシージャーの例: TRACE CT,WTRSTART コマンドを入力した後、コマンド TRACE CT への応答で WTR パラメーターを使用して、トレースをオンにして書き込み機能を接続します。

TRACE CT,WTRSTART=CTWTRTRACE CT,ON,COMP=IRLM,SUB=(DBM)...

(z/OS asks for a reply)...R 15,WTR=CTWTR,ENDTRACE CT,OFF,COMP=IRLM,SUB=(DBM)


第 85 章 TRACE CT (z/OS IRLM) 463

...(Wait to make sure trace buffers are externalized.)

TRACE CT,WTRSTOP=CTWTR

トレースを循環方式で開始および停止するプロシージャーの例: このプロシージャーで取り込まれるトレースは、IRLM が提供する限定された数のバッファーに保管されます。それぞれのバッファーは、前のバッファーがいっぱいになると再利用されます。トレースをこの循環方式で開始するには、次のコマンドを入力してください。

TRACE CT,ON,COMP=IRLM...(z/OS asks for a reply)...

R 15,END...TRACE CT,OFF,COMP=IRLM

TRACE CT ON を設定する影響: 各アクティブ・サブネーム・タイプそれぞれにつき 0.7 MB までの ECSA が必要です。IRLM は開始時に自分自身のトレースを初期化するため、DISPLAY TRACE コマンドを実行するとすべてのトレースがオフとして表示されます。TRACE ON コマンドを出した後は、報告書には正確に反映されます。ただし、2 つのサブネーム・タイプ INT と EXT は例外で、これらをオフにすることはできません。



第 4 部付録


サブシステム・パラメーターのディレクトリー

この付録では、サブシステム・パラメーターについて説明します。


v 『サブシステム・パラメーターおよび DSNHDECP 値の編集』

v 『サブシステム・パラメーターおよび DSNHDECP 値のディレクトリー』

サブシステム・パラメーターおよび DSNHDECP 値の編集DB2 をインストール、マイグレーション、または更新するたびに、サブシステム・パラメーター・モジュールがジョブ DSNTIJUZ によって生成されます。データ専用のサブシステム・パラメーター・ロード・モジュールを形成するために、7 つのマクロが展開されます。これには、ISPF パネルを使用して選択した DB2 実行時パラメーターが含まれています。これらの 7 つのマクロは、DSN6ARVP、 DSN6ENV、DSN6FAC、DSN6LOGP、DSN6SPRM、DSN6SYSP、および DSN6GRP です。

データしか入っていないロード・モジュール DSNHDECP がジョブ DSNTIJUZ により生成されます。これは、アプリケーション・プログラミング・デフォルトを含んでいます。

サブシステム・パラメーターおよび DSNHDECP 値のディレクトリー表 36 には、各マクロ・パラメーター、そのマクロのある場所、インストール・パネル名、そのマクロのオンライン更新可否が記載されています。オンライン更新機能は、DSNHDECP マクロには適用されません。このため、これらのパラメーターに対しては値を記載してありません。

一部のパラメーターは、オンラインで更新されると、システムの動きが変わる結果となります。これらのパラメーターには以下があります。

v PARTKEYU

v SYSADM/SYSADM2

v CACHEDYN

v MAXKEEPD

v XLKUPDLT

表 36. サブシステム・パラメーターおよび DSNHDECP 値のディレクトリー

パラメーターマクロパネルオンライン更新

ABEXP DSN6SPRM DSNTIPO はいABIND DSN6SPRM DSNTIPO はいACCUMACC DSN6SYSP DSNTIPN はいACCUMUID DSN6SYSP DSNTIPN はいAEXITLIM DSN6SPRM DSNTIPP はいAGCCSID DSNHDECP DSNTIPF ―ALCUNIT DSN6ARVP DSNTIPA はい


#

#

#

|

|

|

|

|

|

|

|||||

表 36. サブシステム・パラメーターおよび DSNHDECP 値のディレクトリー (続き)


ALL/DB 名 DSN6SPRM DSNTIPS いいえAMCCSID DSNHDECP DSNTIPF ―APPENSCH DSNHDECP DSNTIPF ―ARCPFX1 DSN6ARVP DSNTIPH はいARCPFX2 DSN6ARVP DSNTIPH はいARCRETN DSN6ARVP DSNTIPA はいARCWRTC DSN6ARVP DSNTIPA はいARCWTOR DSN6ARVP DSNTIPA はいARC2FRST DSN6LOGP DSNTIPO はいASCCSID DSNHDECP DSNTIPF ―ASSIST DSN6GRP DSNTIPK いいえAUDITST DSN6SYSP DSNTIPN いいえAUTH DSN6SPRM DSNTIPP いいえAUTHCACH DSN6SPRM DSNTIPP はいBACKODUR DSN6SYSP DSNTIPL いいえBINDNV DSN6SPRM DSNTIPP はいBLKSIZE DSN6ARVP DSNTIPA はいBMPTOUT DSN6SPRM DSNTIPI はいCACHEDYN DSN6SPRM DSNTIP8 はいCACHEDYN_FREELOCAL DSN6SPRM ― はいCACHEPAC DSN6SPRM DSNTIPP いいえCACHERAC DSN6SPRM DSNTIPP いいえCATALOG DSN6ARVP DSNTIPA はい" DSN6SPRM DSNTIPA2 ―CDSSRDEF DSN6SPRM DSNTIP8 はいCHARSET DSNHDECP DSNTIPF ―CHGDC DSN6SPRM DSNTIPO はいCHKFREQ DSN6SYSP DSNTIPL はいCMTSTAT DSN6FAC DSNTIPR いいえCOMCRIT DSN6SPRM ― はいCOMPACT DSN6ARVP DSNTIPA はいCOMPAT DSNHDECP ― ―CONDBAT DSN6SYSP DSNTIPE はいCONTSTOR DSN6SPRM DSNTIPE はいCOORDNTR DSN6GRP DSNTIPK いいえCTHREAD DSN6SYSP DSNTIPE はいDBACRVW DSN6SPRM DSNTIPP はいDBPROTCL DSN6SYSP DSNTIP5 はいDATE DSNHDECP DSNTIP4 ―DATELEN DSNHDECP DSNTIP4 ―DB2SUPLD DSNHDECP ― ―DDF DSN6FAC DSNTIPR いいえDEALLCT DSN6LOGP DSNTIPA はいDECARTH DSNHDECP DSNTIP4 ―DECDIV3 DSN6SPRM DSNTIPF いいえDECIMAL DSNHDECP DSNTIPF ―DEFLANG DSNHDECP DSNTIPF ―DEFLTID DSN6SPRM DSNTIPP いいえDELIM DSNHDECP DSNTIPF ―DESCSTAT DSN6SPRM DSNTIP4 はいDLDFREQ DSN6SYSP DSNTIPL はいDLITOUT DSN6SPRM DSNTIPI はい


#####

|###|#

|

#####



DSHARE DSN6GRP DSNTIPA1 いいえDSMAX DSN6SPRM DSNTIPC はいDSQLDELI DSNHDECP DSNTIPF ―DSSTIME DSN6SYSP DSNTIPN はいDSVCI DSN6SYSP DSNTIP7 はいDYNRULES DSNHDECP DSNTIP4 ―EDMBFIT DSN6SPRM DSNTIP8 はいEDMDBDC DSN6SPRM DSNTIPC はいEDMSTMTC DSN6SPRM DSNTIPC はいEDMPOOL DSN6SPRM DSNTIPC はいEDPROP DSN6SPRM DSNTIPO はいENSCHEME DSNHDECP DSNTIPF ―EVALUNC DSN6SPRM DSNTIP8 はいEXTRAREQ DSN6SYSP DSNTIP5 はいEXTRASRV DSN6SYSP DSNTIP5 はいEXTSEC DSN6SYSP DSNTIPR はいGCCSID DSNHDECP DSNTIPF ―GRPNAME DSN6GRP DSNTIPK いいえHOPAUTH DSN6SPRM DSNTIP5 いいえIDBACK DSN6SYSP DSNTIPE はいIDFORE DSN6SYSP DSNTIPE はいIDTHTOIN DSN6FAC DSNTIPR はいIDXBPOOL DSN6SYSP DSNTIP1 はいIMMEDWRI DSN6GRP DSNTIP8 はいINLISTP DSN6SPRM ― はいIRLMAUT DSN6SPRM DSNTIPI いいえIRLMPRC DSN6SPRM DSNTIPI いいえIRLMRWT DSN6SPRM DSNTIPI いいえIRLMSID DSN6SPRM DSNTIPI いいえIRLMSWT DSN6SPRM DSNTIPI はいIXQTY DSN6SYSP DSNTIP7 はいLBACKOUT DSN6SYSP DSNTIPL いいえLC_CTYPE DSNHDECP DSNTIPF ―LEMAX DSN6SPRM DSNTIP7 いいえLOBVALA DSN6SYSP DSNTIP7 はいLOBVALS DSN6SYSP DSNTIP7 はいLOGAPSTG DSN6SYSP DSNTIPL いいえLRDRTHLD DSN6SYSP DSNTIPE はいMAINTYPE DSN6SPRM DSNTIP8 はいMAX_NUM_CUR DSN6SPRM DSNTIPX はいMAX_ST_PROC DSN6SPRM DSNTIPX はいMAXARCH DSN6LOGP DSNTIPA いいえMAXDBAT DSN6SYSP DSNTIPE はいMAXKEEPD DSN6SPRM DSNTIPE はいMAXRBLK DSN6SPRM DSNTIPC はいMAXRTU DSN6LOGP DSNTIPA はいMAXTYPE1 DSN6FAC DSNTIPR はいMCCSID DSNHDECP DSNTIPF ―MEMBNAME DSN6GRP DSNTIPK いいえMGEXTSZ DSN6SYSP DSNTIP7 はいMINSTOR DSN6SPRM DSNTIPE はいMIXED DSNHDECP DSNTIPF ―

サブシステム・パラメーターのディレクトリー 469

||

|

||

|

|

|||||

|

|



MON DSN6SYSP DSNTIPN いいえMONSIZE DSN6SYSP DSNTIPN いいえMORE_UNION_DISTRIBUTION DSN6SPRM - はいNEWFUN DSNHDECP DSNTIPA1 ―NPGTHRSH DSN6SPRM ― はいNUMLKTS DSN6SPRM DSNTIPJ はいNUMLKUS DSN6SPRM DSNTIPJ はいOJPERFEH DSN6SPRM ― いいえOPTHINTS DSN6SPRM DSNTIP8 はいOUTBUFF DSN6LOGP DSNTIPL いいえPADIX DSN6SPRM DSNTIPE はいPADNTSTR DSNHDECP DSNTIP4 いいえPARAMDEG DSN6SPRM DSNTIP8 はいPARTKEYU DSN6SPRM DSNTIP8 はいPCLOSEN DSN6SYSP DSNTIPL はいPCLOSET DSN6SYSP DSNTIPL はいPOOLINAC DSN6FAC DSNTIP5 はいPRIQTY DSN6ARVP DSNTIPA はいPROTECT DSN6ARVP DSNTIPP はいPTASKROL DSN6SYSP ― はいQUIESCE DSN6ARVP DSNTIPA はいRECALL DSN6SPRM DSNTIPO いいえRECALLD DSN6SPRM DSNTIPO はいREFSHAGE DSN6SPRM DSNTIP8 はいRELCURHL DSN6SPRM DSNTIP8 はいRESTART/DEFER DSN6SPRM DSNTIPS いいえRESYNC DSN6FAC DSNTIPR はいRETLWAIT DSN6SPRM DSNTIPI はいRETVLCFK DSN6SPRM DSNTIP8 はいRGFCOLID DSN6SPRM DSNTIPZ いいえRGFDBNAM DSN6SPRM DSNTIPZ いいえRGFDEDPL DSN6SPRM DSNTIPZ いいえRGFDEFLT DSN6SPRM DSNTIPZ いいえRGFESCP DSN6SPRM DSNTIPZ いいえRGFFULLQ DSN6SPRM DSNTIPZ いいえRGFINSTL DSN6SPRM DSNTIPZ いいえRGFNMORT DSN6SPRM DSNTIPZ いいえRGFNMPRT DSN6SPRM DSNTIPZ いいえRLF DSN6SYSP DSNTIPO いいえRLFAUTH DSN6SYSP DSNTIPP はいRLFERR DSN6SYSP DSNTIPO はいRLFERRD DSN6FAC DSNTIPR はいRLFTBL DSN6SYSP DSNTIPO はいROUTCDE DSN6SYSP DSNTIPO いいえRRULOCK DSN6SPRM DSNTIPI はいSCCSID DSNHDECP DSNTIPF ―SECQTY DSN6ARVP DSNTIPA はいSEQCACH DSN6SPRM DSNTIPE はいSEQPRES DSN6SPRM DSNTIPE はいSITETYP DSN6SPRM DSNTIPO いいえSJMXPOOL DSN6SPRM DSNTIP8 はいSJTABLES DSN6SPRM ― はい


####|||||

#

|||||

|

|||||

#####|



SKIPUNCI DSN6SPRM DSNTIP8 はいSMF89 DSN6SYSP ― はいSMFACCT DSN6SYSP DSNTIPN いいえSMFSTAT DSN6SYSP DSNTIPN いいえSMSDCFL DSN6SPRM ― はいSMSDCIX DSN6SPRM ― はいSQLDELI DSNHDECP DSNTIPF ―SRTPOOL DSN6SPRM DSNTIPC はいSSID DSNHDECP DSNTIPM ―STARJOIN DSN6SPRM DSNTIP8 はいSTATHIST DSN6SPRM DSNTIPO はいSTATIME DSN6SYSP DSNTIPN はいSTATROLL DSN6SPRM DSNTIPO はいSTATSINT DSN6SPRM DSNTIPO はいSTDSQL DSNHDECP DSNTIP4 ―STORMXAB DSN6SYSP DSNTIPX はいSTORPROC DSN6SYSP DSNTIPX いいえSTORTIME DSN6SYSP DSNTIPX はいSUPERRS DSN6SPRM DSNTIPM はいSUPPRESS_TS_CONV_WARNING DSN6SPRM ― はいSVOLARC DSN6ARVP DSNTIPA はいSYNCVAL DSN6SYSP DSNTIPN はいSYSADM DSN6SPRM DSNTIPP はいSYSADM2 DSN6SPRM DSNTIPP はいSYSOPR1 DSN6SPRM DSNTIPP はいSYSOPR2 DSN6SPRM DSNTIPP はいTBSBPOOL DSN6SYSP DSNTIP1 はいTCPALVER DSN6FAC DSNTIP5 はいTCPKPALV DSN6FAC DSNTIP5 はいTIME DSNHDECP DSNTIP4 ―TIMELEN DSNHDECP DSNTIP4 ―TRACSTR DSN6SYSP DSNTIPN いいえTRACTBL DSN6SYSP DSNTIPN いいえTRKRSITE DSN6SPRM DSNTIPO いいえTSQTY DSN6SYSP DSNTIP7 はいTSTAMP DSN6ARVP DSNTIPH はいTWOACTV DSN6LOGP DSNTIPH いいえTWOARCH DSN6LOGP DSNTIPH いいえTWOBSDS DSN6LOGP ― いいえUGCCSID DSNHDECP DSNTIPF ―UIFCIDS DSN6SYSP DSNTIPN はいUMCCSID DSNHDECP DSNTIPF ―UNION_COLNAME_7 DSN6SPRM ― はいUNIT DSN6ARVP DSNTIPA はいUNIT2 DSN6ARVP DSNTIPA はいURCHKTH DSN6SYSP DSNTIPL はいURLGWTH DSN6SYSP DSNTIPL はいUSCCSID DSNHDECP DSNTIPF ―UTIMOUT DSN6SPRM DSNTIPI はいVOLTDEVT DSN6SPRM DSNTIPA2 はいWLMENV DSN6SYSP DSNTIPX はいXLKUPDLT DSN6SPRM DSNTIPI はい

サブシステム・パラメーターのディレクトリー 471

|

#####

||||

||

|||||

#####

|

DB2 ライブラリーの使用方法

このライブラリー内のマニュアル・タイトルは、DB2 Universal Database for z/OS

バージョン 8 で始まります。ただしこのライブラリー内のあるマニュアルから別のマニュアルへの参照は短縮されており、製品名、バージョン、およびリリースは含まれていません。そのかわりに、その参照ではその情報が収容されたセクションを直接ポイントします。このライブラリー内のマニュアル一覧のすべて、および各マニュアル内のセクションは、当マニュアルの最後に記載された参考文献をご覧ください。) にアクセスしてください。

データベース管理システムに関連する最も大変な仕事は、やるべき仕事に関して要求を発行すること、およびその応答を受け取ることです。この仕事は、最終使用と呼ばれています。また、その他の仕事も必要です。例えば、システムのパラメーター定義、所定の位置にそのデータを入れるなどです。DB2 に関連するこれらの仕事は以下のような主要なカテゴリーにグループ化されます (DB2 の新リリースに対する以下のすべての仕事に関係する追加情報は、「DB2 リリース・ガイド」をご覧ください)。

インストール: 読者が DB2 に関連して、そのシステムのみをインストールする場合、必要なのは「DB2 インストレーション・ガイド」がすべてです。

データ共用機能を使用予定の場合は、「DB2 データ共用: 計画および管理」も必要です。このマニュアルには、データ共用時のインストールの注意点が記載されています。

共通基準の要件に適合するために DB2 サブシステムをセットアップする場合は、「DB2 Common Criteria Guide」が必要です。このマニュアルには、共通基準に関する DB2 UDB for z/OS ライブラリー内の他の情報より優先する情報が記載されています。

最終使用: エンド・ユーザーは SQL ステートメントを出してデータを取り出します。エンド・ユーザーは SQL ステートメントを使ってデータの挿入、更新、および削除も行います。エンド・ユーザーは、SQL 入門、SPUFI 使用方法の詳細説明、および SQL ステートメント・タイプへの ABC 順の参照を必要とする可能性があります。この情報は、「DB2 アプリケーション・プログラミングおよび SQL ガイド」および「DB2 SQL 解説書」にあります。

エンド・ユーザーは DB2 Query Management Facility (QMF) または中にはその他のプログラムを使用して SQL ステートメントを発行する可能性もあり、そのライセンス・プログラム用ライブラリーが、必要となるすべての説明と参照資料を提供します。DB2 QMF ライブラリーにおけるタイトル一覧は、当マニュアルの最後にある参考文献をご覧ください。

アプリケーション・プログラミング: 一部ユーザーは、DB2 のことを知らずに、SQL ステートメントが指定されたプログラムを使用して DB2 にアクセスします。DB2 のアプリケーション・プログラマーがこれらのプログラムをコーディングしま


す。これらのアプリケーション・プログラマーが SQL ステートメントをコーディングするには、エンド・ユーザーがアクセスするのと同じリソースを必要とします。

また、アプリケーション・プログラマーは、以下のような多くのトピックに関する説明が必要です。

v DB2 とホスト・プログラム (例えば、Java、C、または COBOL コーディング)

との間のデータ転送方法。

v SQL ステートメントを組み込んだプログラムをコンパイルするための準備方法。

v 2 つのシステムから同時にデータを処理する方法、例えば、DB2 と IMS、またはDB2 と CICS。

v 複数のオペレーティング・システム全体にわたる分散アプリケーションを作成する方法。

v Open Database Connectivity (ODBC) を使用したアプリケーションをコーディングして DB2 サーバーにアクセスする方法。

v Java プログラム言語でアプリケーションをコーディングして DB2 サーバーにアクセスする方法。

SQL を含むホスト・プログラムの作成に必要な資料は、「DB2 アプリケーション・プログラミングおよび SQL ガイド」と「DB2 アプリケーション・プログラミングおよび Java リファレンス」を参照してください。DB2 ODBC または ODBC を使用するアプリケーションを作成して DB2 サーバーをアクセスするのに必要となる資料は、「DB2 ODBC ガイドおよび解説書」を参照してください。エラーの処理方法は、「DB2 コード」を参照してください。

分散環境での作業を予定している場合は、「リモート DRDA リクエスターおよびサーバー解説書」を参照してください。

複数のオペレーティング・システムにわたるアプリケーションを作成するための詳細については、「IBM DB2 Universal Database SQL Reference for Cross-Platform

Development」を参照してください。

システムおよびデータベース管理: 管理は、ほとんどその他すべてをカバーします。「DB2 管理ガイド」には、以下のセクション間でこれらの作業を分けて記載してあります。

v 「DB2 管理ガイド」第 2 部 (第 1 巻) には、データベース設計時に決定すべきことを記載してあり、DB2 オブジェクトの作成と変更、データのロード、および変更に対する調整によりその設計をインプリメントする方法を説明してあります。

v 「DB2 管理ガイド」第 3 部 (第 1 巻) には、DB2 システムとデータへのアクセスを制御する方法を記載してあり、DB2 使用の局面を監査し、その他のセキュリティーと監査に関する考慮事項に対処します。

v 「DB2 管理ガイド」第 4 部 (第 1 巻) には、日々発生する操作上のステップが記載されており、何か障害が発生した場合にそのリカバリーのために準備しておくべきステップについて検討を加えてあります。


v 「DB2 管理ガイド」第 5 部 (第 2 巻) には、DB2 システムとその一部のパフォーマンスをモニターする方法について記載してあります。また、ここには、いくつかの部分を一層迅速に実行するために行えることを一覧にしてあります。

DB2 の許可検査用に RACF アクセス制御モジュールを使用予定の場合、「DB2

RACF Access Control Module Guide」が必要となります。

データベース設計と操作手順計画を行うためだけに読者が DB2 に関与している場合は、「DB2 管理ガイド」が必要です。また、DB2 オブジェクトの作成、特権の付与、ユーティリティー・ジョブの実行などにより読者自身の計画を実施したい場合は、以下のマニュアルも必要となります。

v 「DB2 SQL 解説書」。このマニュアルには、オブジェクトの作成/変更/ドロップ、および特権の付与/取り消しを行うのに使用する SQL ステートメントが記載されています。

v 「DB2 ユーティリティー・ガイドおよび解説書」。このマニュアルにはユーティリティーの実行方法が記載してあります。

v 「DB2 コマンド解説書」。このマニュアルにはコマンドの実行方法が記載してあります。

データ共用を使用する計画の場合、「DB2 データ共用: 計画および管理」。このマニュアルには、データ共用の計画と実現方法が記載してあります。

システムとデータベース管理に関する追加情報は、「DB2 メッセージ」と「DB2 コード」を参照してください。このマニュアルには、DB2 が発行するメッセージとコード、およびその説明と推奨される対応方法を記載してあります。

診断: 診断を行う読者は、DB2 プログラム内のエラーの検出と記述を行います。この診断を行う読者は、対応処置の提言および適用を行う可能性もあります。この仕事に関係するマニュアルは、「DB2 Diagnosis Guide and Reference」、「DB2 メッセージ」、および「DB2 コード」です。

DB2 ライブラリーの使用方法 475

特記事項

本書は米国 IBM が提供する製品およびサービスについて作成したものです。

本書に記載の製品、サービス、または機能が日本においては提供されていない場合があります。日本で利用可能な製品、サービス、および機能については、日本 IBM

の営業担当員にお尋ねください。本書で IBM 製品、プログラム、またはサービスに言及していても、その IBM 製品、プログラム、またはサービスのみが使用可能であることを意味するものではありません。これらに代えて、IBM の知的所有権を侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用することができます。ただし、IBM 以外の製品とプログラムの操作またはサービスの評価および検証は、お客様の責任で行っていただきます。

IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を保有している場合があります。本書の提供は、お客様にこれらの特許権について実施権を許諾することを意味するものではありません。実施権についてのお問い合わせは、書面にて下記宛先にお送りください。

〒106-8711東京都港区六本木 3-2-12IBM World Trade Asia CorporationIntellectual Property Law & Licensing

以下の保証は、国または地域の法律に沿わない場合は、適用されません。 IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任を負わないものとします。国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限を受けるものとします。

この情報には、技術的に不適切な記述や誤植を含む場合があります。本書は定期的に見直され、必要な変更は本書の次版に組み込まれます。 IBM は予告なしに、随時、この文書に記載されている製品またはプログラムに対して、改良または変更を行うことがあります。

本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものではありません。それらの Web サイトにある資料は、この IBM 製品の資料の一部ではありません。それらの Web サイトは、お客様の責任でご使用ください。

IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、自ら適切と信ずる方法で、使用もしくは配布することができるものとします。

本プログラムのライセンス保持者で、(i) 独自に作成したプログラムとその他のプログラム（本プログラムを含む）との間での情報交換、および (ii) 交換された情報の相互利用を可能にすることを目的として、本プログラムに関する情報を必要とする方は、下記に連絡してください。


IBM CorporationJ46A/G4555 Bailey AvenueSan Jose, CA 95141-1003U.S.A.

本プログラムに関する上記の情報は、適切な使用条件の下で使用することができますが、有償の場合もあります。

本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれと同等の条項に基づいて、IBM より提供されます。

本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。より具体性を与えるために、それらの例には、個人、企業、ブランド、あるいは製品などの名前が含まれている場合があります。これらの名称はすべて架空のものであり、名称や住所が類似する企業が実在しているとしても、それは偶然にすぎません。

著作権使用許諾:

本書には、様々なオペレーティング・プラットフォームでのプログラミング手法を例示するサンプル・アプリケーション・プログラムがソース言語で掲載されています。お客様は、サンプル・プログラムが書かれているオペレーティング・プラットフォームのアプリケーション・プログラミング・インターフェースに準拠したアプリケーション・プログラムの開発、使用、販売、配布を目的として、いかなる形式においても、IBM に対価を支払うことなくこれを複製し、改変し、配布することができます。このサンプル・プログラムは、あらゆる条件下における完全なテストを経ていません。従って IBM は、これらのサンプル・プログラムについて信頼性、利便性もしくは機能性があることをほのめかしたり、保証することはできません。

プログラミング・インターフェース情報本書の目的は、DB2 Universal Database for z/OS (DB2 UDB for z/OS) および関連サブシステムのコマンドをご使用になるお客さまの手助けをすることです。本書では、主として DB2 が提供する汎用プログラミング・インターフェースと関連ガイダンス情報を記述しています。

お客様は、汎用プログラミング・インターフェースを使用して、DB2 のサービスを利用するプログラムを作成することができます。

ただし、本書は、製品固有プログラミング・インターフェースと関連ガイダンス情報も記述しています。

プロダクト・センシティブ・プログラミング・インターフェースにより、お客さまが IBM ソフトウェア製品に対して、診断、変更、モニター、修理、調整、チューニングなどの作業を実行できます。これらのインターフェースを使用すると、IBM

のソフトウェア製品の詳細設計やそのインプリメンテーションとの依存関係が発生します。このため、プロダクト・センシティブ・プログラミング・インターフェースは、前述の特別な目的にだけ使用してください。このようにこれらのインターフェースは、詳細設計やインプリメンテーションに依存しているので、それらを使用


したプログラムは、新しい製品のリリース・バージョンを実行するとき、あるいは保守サービスの結果として、変更が必要になることがあります。

製品固有プログラミング・インターフェース

製品固有プログラミング・インターフェースと関連ガイダンス情報は、それが現れた場所で「製品固有プログラミング・インターフェース」および「関連ガイダンス情報 ...」というマーキングで示されます。

製品固有プログラミング・インターフェースの終り

商標以下は、IBM Corporation の商標です。

AT

BookManager

C/370

CICS

CICS Connection

DataPropagator

DB2

DB2 Universal Database

DFSMSdfp

DFSMSdss

DFSMShsm

Distributed Relational Database Architecture

DRDA

Enterprise Storage Server

ES/3090

eServer

FlashCopy

IBM

IBM Registry

ibm.com

IMS

iSeries

Language Environment

MVS

OpenEdition

OS/390

Parallel Sysplex

PR/SM

QMF

RACF

Redbooks

SOM

System Object Model

System/390

TotalStorage

VTAM

WebSphere

z/OS

Java およびすべての Java 関連の商標およびロゴは、Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。

Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft Corporation

の米国およびその他の国における商標です。

UNIX は、The Open Group の米国およびその他の国における登録商標です。

特記事項 479

用語集以下の用語および省略語は、DB2 ライブラリーで使用される場合の定義です。

［ア行］アーカイブ・ログ (archive log). アクティブ・ログからコピーされたログ・レコードが入っている DB2 ログの部分。

アクセス方式サービス (access method services).

VSAM キー順データ・セットの定義および複製のために使用される機能。

アクセス・パス (access path). SQL ステートメントに指定されたデータを見付けるために使用されるパス。アクセス・パスには、索引付きパスと順次パスがある。

アクティブ・メンバー状態 (active member state). データ共用グループのメンバーの状態。システム間カップリング・ファシリティーは、各アクティブ・メンバーを特定のタスク、アドレス・スペース、および z/OS システムにより、グループや関連事項で識別する。アクティブでないメンバーは、障害発生メンバーの状態かまたは静止メンバーの状態のいずれかである。

アクティブ・ログ (active log). ログ・レコードが生成されるたびにそれが書き込まれる DB2 ログの部分。アクティブ・ログには常に最新のログ・レコードが入っているのに対し、アーカイブ・ログには、古くなって、アクティブ・ログに適合しなくなったレコードが保持されている。

値 (value). SQL で操作される最小単位のデータ。

アタッチメント機能 (attachment facility). DB2 とTSO、IMS、CICS、またはバッチ・アドレス・スペースとの間のインターフェースの 1 つ。接続機能により、アプリケーション・プログラムは DB2 にアクセスすることができる。

圧縮辞書 (compression dictionary). 圧縮および圧縮解除の処理を制御する辞書。この辞書は、表スペースもしくは表スペース区分のデータから作成される。

アップストリーム (upstream). 同期点ツリーにあるノードで、他のリカバリーまたはリソース管理プログラムに加えて、2 フェーズ・コミットの実行を調整を行う。

アドレス・スペース (address space). 番号 (ASID) によって識別される仮想記憶ページの範囲であり、仮想ページをコンピューターのメモリーの実ページに対応づけるセグメント表とページ表の集まり。

アドレス・スペース ID (address space identifier

(ASID)). アドレス・スペースのためのシステムが割り当てた固有 ID。

アドレス・スペース接続 (address space connection).

関連アドレス・スペースを DB2 に接続した結果。DB2

に接続されたタスクが置かれている各アドレス・スペースに複数のタスク制御ブロック (TCB) があっても、アドレス・スペース接続は 1 つだけである。接続アドレス・スペース (allied address space) およびタスク制御ブロック (task control block) も参照。

アプリケーション (application). ある作業を実行する 1

つのプログラムまたはプログラムの集合のこと。例えば、給与計算アプリケーションなどがある。

アプリケーション管理接続 (application-directed

connection). アプリケーションが SQL CONNECT ステートメントを使用して管理する接続。

アプリケーション処理 (application process). リソースおよびロックを割り当てる単位。アプリケーション処理には、1 つまたは複数のプログラムの実行が含まれる。

アプリケーション・サーバー (application server). リモート・アプリケーションからの要求のターゲット。DB2 環境においては、アプリケーション・サーバー機能は分散データ機能により提供され、リモート・アプリケーションから DB2 データにアクセスする際に使用される。

アプリケーション・プラン (application plan). バインド処理の間に作成される制御構造。 DB2 は、アプリケーション・プランを使用して、ステートメントの実行中に検出した SQL ステートメントを処理する。

アプリケーション・プログラミング・インターフェース(application programming interface (API)). オペレーティング・システムに、あるいは個別に発注可能なライセンス・プログラムに用意されている機能インターフェースであって、高水準言語で書かれたアプリケーション・


|||

プログラムがオペレーティング・システムまたはライセンス・プログラムのデータまたは機能を使用できるようにするためのもの。

アプリケーション・リクエスター (application

requester). アプリケーションに代わって、データに対する DRDA 要求を生成するリモート・システム上のコンポーネント。アプリケーション・リクエスターは、DRDA アプリケーション管理プロトコルを使用してDB2 データベース・サーバーにアクセスする。

アボート延期 UR (postponed abort UR). 未完了またはアボート中だったリカバリー単位で、システム障害または取り消しによって中断され、再始動時のバックアウトを完了していないもの。

アボート中 (in-abort). リカバリー単位の状況。リカバリー単位がロールバックを開始した後、処理が完了する前に DB2 が失敗した場合、再始動中に DB2 はその変更のバックアウトを継続する。

暗黙の forget (implied forget). 仮定打ち切りプロトコルでは、調整プログラムからの 2 番目のフェーズのコミット要求に対する forget の暗黙の応答。参加プログラムが調整プログラムからの後続の要求に応答するとき、応答は暗黙のものとなる。

アンロック (unlock). 以前にロックされたオブジェクトまたはシステム・リソースをリリースして、DB2 内で一般が使用できるように戻す行為。

異常終了 (abend). タスクの異常終了。

異常終了理由コード (abend reason code). DB2 における問題を一意的に識別する 4 バイトの 16 進コード。

一時 XML データ・タイプ (transient XMLdata type).

照会処理中にのみ存在する XML 値のデータ・タイプ。

一時表 (temporary table). 一時データが入っている表。一時表は、大量の行が含まれる照会から、中間結果を保留またはソートする場合に有用である。異なるSQL ステートメントによって作成される 2 つのタイプの一時表は、作成済みの一時表 (created temporary

table) と宣言済み一時表 (Declared temporary table) である。結果表 (result table) と比較。作成済みの一時表(created temporary table) および宣言済み一時表(Declared temporary table) も参照。

一括削除 (mass delete). 1 つの表のすべての行を削除すること。

イテレーター (iterator). SQLJ において、照会の結果セットを含むオブジェクト。イテレーターは、他のホスト言語におけるカーソルと同等のもの。

イテレーター宣言文節 (iterator declaration clause).

SQLJ において、イテレーター宣言クラスを生成するステートメント。イテレーターは、イテレーター宣言クラスのオブジェクト。

イメージ・コピー (image copy). 表スペースの全部もしくは部分の精密な再生。 DB2 全体イメージ・コピー(表スペース全体をコピーする) または増分イメージ・コピー (最後のイメージ・コピー以降修正になったページ分のみコピーする) をとるユーティリティー・プログラムを備えている。

インストール (install). z/OS サブシステムとして操作するために DB2 サブシステムを準備する処理。

インストール検査シナリオ (installation verification

scenario). メインの DB2 機能を実行し、 DB2 が正しくインストールされたかどうかをテストする一連の操作。

インライン・コピー (inline copy). LOAD またはREORG ユーティリティーにより作成されるコピー。インライン・コピーが作成するデータ・セットは、論理的には、読み取り専用アクセス (SHRLEVEL

REFERENCE) で COPY ユーティリティーを実行して作成される完全なイメージ・コピーと同じである。

ウォーム・スタート (warm start). 通常の DB2 再始動処理。これは、ログ・レコードの読み取りおよび処理を含み、DB2 制御下のデータに整合性が保たれる。コールド・スタート (cold start) と比較。

エージェント (agent). DB2 で使用される場合は、DB2

作業単位にかかわるすべてのプロセスに関連した構造。接続エージェント (allied agent) は、一般に接続スレッド (allied thread) と同義である。システム・エージェント (System agent) は、プリフェッチ処理、据え置き書き出し、およびサービス・タスクなどの接続エージェントとは無関係にタスクを処理する作業単位である。

エクサバイト (exabyte). プロセッサーにおける実記憶域および仮想記憶域およびチャネル・ボリューム :

1 152 921 504 606 846 976 バイトまたは 260。

エスケープ文字 (escape character). SQL 区切り ID を囲むために使用されるシンボル。エスケープ文字は、COBOL アプリケーション以外では二重引用符 (") である。ユーザーが記号を割り当てる COBOL アプリケーションの場合は、二重引用符かアポストロフィ (') のいずれかになる。

エラー・ページ範囲 (error page range). 物理的に損傷していると考えられるページ範囲。 DB2 では、ユーザーがこの範囲内にあるページをアクセスすることは許可されない。


||

エンクレーブ (enclave). 言語処理環境では、ルーチンの独立した集合であり、そのうちの 1 つが主ルーチンとして指定される。エンクレーブはプログラムまたは実行単位と類似している。

エンコード体系 (encoding scheme). 文字データを表現する 1 組の規則 (ASCII、EBCDIC、またはユニコード)。

エンティティー (entity). ある組織にとって関心のある、有効なオブジェクト。

オペレーターへの書き込み (write to operator(WTO)).

ユーザーがコーディングするオプショナルのサービスであり、システム・コンソールのオペレーターにメッセージを書き出して、訂正が必要である可能性があるエラーおよび異常なシステム状態をオペレーターに知らせる(z/OS の場合)。

親キー (parent key). 参照制約の親表内の基本キーまたは固有キー。親キーの値により、参照制約内の外部キーの有効な値を判別する。

親行 (parent row). 基本キー値が従属行の外部キー値である行。

親タスク (originating task). 並列グループにおいて、照会の一部を並列で実行している他の実行単位 (並列タスクと呼ばれる) からデータを受信する 1 次エージェント。

親表 (parent table). 基本キーが従属表の外部キーによって参照される表。

親表スペース (parent table space). 親表が入っている表スペース。その表の従属表が入っている表スペースは、従属表スペースである。

親ロック (parent lock). 明示的階層ロッキングでは、リソース上に保持されているロックであり、より低い階層にある子ロックを所持している可能性がある。親ロックは通常、表スペース・ロックまたはパーティション・インテント・ロックである。子ロック (child lock) も参照。

オンライン・リソース定義 (resource definition online).

表をアセンブルせずに、オンラインで CICS リソースを定義するために使用する CICS 機能。

［カ行］カーソル (cursor). 結果表の行の一部の順序セット内で、単一または複数の行を指すためにアプリケーショ

ン・プログラムが使用する、名前の付いた制御構造。カーソルは、結果表から行を検索、更新、または削除するために使用できる。

カーソル固定 (cursor stability (CS)). 最大の並行性を提供する分離レベル。これは、アンコミット・データを読み取る機能はない。作業単位は、カーソル固定を用いて、その非コミット変更とそのカーソルの現行行に対してのみロックを保持する。

カーソル表 (cursor table (CT)). 実行中のアプリケーション・プロセスによって使用されるスケルトン・カーソル表のコピー。

カーソル・センシティビティー (cursor sensitivity). カーソル内で、データベースの更新が後続の FETCH ステートメントから可視になる度合い。カーソルは、位置指定された更新、および自身の名前を指定した削除ステートメントによって行われた変更を感知できる。またカーソルは、検索された更新または削除ステートメント、あるいは他のカーソルによって行われた変更も感知できる。これらの変更は、このアプリケーション・プロセスによるか、または別のアプリケーション・プロセスによって行われる可能性がある。

外部関数 (external function). 本体があるプログラム言語で書かれた関数。スカラーの引数値を受け取って、各呼び出しごとにスカラーの結果を生成する。ソース関数(sourced function)、組み込み関数 (built-in function)、および SQL 関数 (SQL function) と比較。

外部キー (foreign key). 制約関係の従属表の中の列または列セット。キーは、列の数と記述が、親表の基本キーと同じでなければならない。各外部キー値は、関係する親表の中の親キーと一致するか、またはヌルである必要がある。

外部結合 (outer join). 結合されている両方の表の一致した行が入っており、結合されている表の不一致の行の一部またはすべてを保存する、結合操作の結果。結合(join) も参照。

外部サブシステム・モジュール表 (external subsystem

module table(ESMT)). IMS では、どの接続モジュールがロードされるべきかを指定する表。

外部プロシージャー (external procedure). ユーザーが作成したアプリケーション・プログラムで、プログラミング言語で書かれた SQL CALL ステートメントで呼び出すことができる。SQL プロシージャー (SQL

procedure) と比較。

外部ルーチン (external routine). 外部プログラム言語で書かれたコードに基づくユーザー定義関数またはストアード・プロシージャー。

用語集 483

||||||

会話 (conversation). トランザクションの処理中の通信を可能にする SNA 論理装置間 (LU-LU) セッションを介した、アプリケーションとリモート・トランザクション・プログラムの間の LU 6.2 または拡張プログラム間通信機能 (APPC) を基にした通信。

拡張回復機能 (extended recovery facility (XRF)). 高可用性アプリケーションと指定された端末の間のセッション中における、 z/OS、 VTAM、ホスト・プロセッサー、または高可用性アプリケーションの障害による影響を最小限にする機能。この機能は、障害が発生しているサブシステムからのセッションを引き受けるための代替サブシステムを提供する。

拡張変換 (expanding conversion). 変換されたストリングがソース・ストリングよりも長い場合に発生する処理。例えば、この処理は、DBCS 文字が入った ASCII

混合データ・ストリングが EBCDIC 混合データ・ストリングに変換されるときに発生する。変換されたストリングは、シフト・コードが追加されるため長くなる。

カスケード削除 (cascade delete). 削除された親行の下層行をすべて削除するときに DB2 が強制する参照制約の方法。

下層 (descendent). あるオブジェクトの従属であるか、あるオブジェクトの下層の従属であるオブジェクト。

仮想記憶アクセス方式 (Virtual Storage Access Method

(VSAM)). ディスク装置上の固定長および可変長レコードの、直接または順次の処理のアクセス方式。 VSAM

データ・セットまたはファイルの中のレコードは、キー・フィールドによる論理順序 (キーの順序) で編成するか、データ・セットまたはファイルに書き込まれた物理的な順序 (入力した順序) で編成するか、または相対レコード番号によって編成することができる (z/OS の場合)。

下層行 (descendent row). 別の行の従属である行、または従属行の従属である行。

下層表 (descendent table). 別の表の従属である表、または従属表の従属である表。

カタログ (catalog). DB2 において、表、視点、および索引などのオブジェクトの記述が入っている表の集合。

カタログ表 (catalog table). DB2 カタログ内の任意の表。

カップリング・ファシリティー (coupling facility). カップリング・ファシリティー制御プログラムを実行し、Parallel Sysplex® 内で高速キャッシング、リスト処理、およびロック機能を提供する、特別の PR/SM™ LPAR

論理区画。

カップリング・ファシリティー・リソース管理(coupling facility resource management). Parallel

Sysplex 内でカップリング・ファシリティー・リソースを管理するサービスを提供する z/OS のコンポーネント。この管理には、カップリング・ファシリティーおよび構造の要件が満たされているかを確認する CFRM ポリシーの制約が含まれている。

ガバナー (governor). リソース限定機能 (resource limit

facility) を参照。

可変関数 (variant function). nondeterministic 関数(nondeterministic function) も参照。

可変長ストリング (varying-length string). セットの限界内で長さが変化する文字ストリングもしくは漢字ストリング。固定長ストリング (fixed-length string) と比較。

環境 (environment). 機能のパフォーマンスをサポートするために使用される、論理および物理リソースの名前の集合。

環境ハンドル (environment handle). DB2 ODBC では、アプリケーションの状態に関するグローバル情報を含むデータ・オブジェクト。接続ハンドルを割り当てる前に、環境ハンドルを割り当てる必要がある。 1 つのアプリケーションに対して 1 つだけ環境ハンドルを割り当てることができる。

漢字ストリング (graphic string). DBCS 文字の列。

関数 (function). プログラム (関数本体) として体現されるマッピングで、ゼロ個以上の入力値 (引数) によって呼びだされた単一値 (結果) を戻す。集約関数(aggregate function) およびスカラー関数 (scalar

function) も参照。

関数にはユーザーに定義されたもの、組み込まれたもの、または DB2 により生成されたものがある。(組み込み関数 (built-in function)、cast 関数 (cast function)、外部関数 (external function)、ソース関数 (sourced

function)、SQL 関数 (SQL function)、およびユーザー定義関数 (user-defined function) も参照。)

関数解決 (function resolution). DBMS への内部プロセス。これにより、関数呼び出しは特定の関数インスタンスにバインドされる。このプロセスは、関数名、引数のデータ・タイプ、および適用できるスキーマ名 (SQL パスと呼ばれる) のリストを使用して、選択を行う。このプロセスは、関数選択 (function selection) とも呼ばれる。


|||||||

#####

######

関数シグニチャー (function signature). パラメーターすべてのデータ・タイプを指定した完全修飾関数名の論理連結。

関数選択 (function selection). 関数解決 (function

resolution) を参照。

関数の実装者 (function implementer). 関数プログラムおよび関数パッケージの所有者の許可 ID。

関数の定義者 (function definer). CREATE FUNCTION

ステートメントに指定された関数のスキーマの所有者の許可 ID。

関数パッケージ (function package). 関数プログラム用の DBRM をバインディングした結果得られるパッケージ。

関数パッケージ所有者 (function package owner). 関数プログラムの DBRM を関数パッケージにバインドするユーザーの許可 ID。

完全エスケープ・マッピング (fully escaped mapping).

SQL ID が列名の場合、SQL ID から XML 名へのマッピング。

感知カーソル (sensitive cursor). 結果表がマテリアライズされた後でデータベースに対して行われた変更を感知するカーソル。

管理権限 (administrative authority). DB2 が定義する関連する特権。ある人の ID に管理権限の 1 つを付与すると、その人はその管理権限に関連したすべての特権を持つことになる。

完了必須 (must-complete). データ保全性を維持するため操作全体を完了する必要を生じた、DB2 処理中の状態。

関連アドレス・スペース (allied address space). DB2

の外部にあり、DB2 に接続されるストレージ域。関連アドレス・スペースは、DB2 サービスを要求することができる。

関連スレッド (allied thread). ローカル DB2 サブシステムで発信され、リモート DB2 サブシステムでアクセスできるスレッド。

キー (key). 表、索引、または参照制約の記述の中で示されている 1 つの列または一連の順序付けされた列。複数のキーの一部に同一の列がなり得る。

キー順データ・セット (key-sequenced data set

(KSDS)). レコードがキーの順序でロードされ、索引によって制御される、VSAM ファイルまたはデータ・セット。

キーワード (keyword). SQL では、SQL ステートメントで使用されたオプションを識別する名前。

期間 (duration). 時間間隔を表す数値。日付期間 (date

duration)、ラベル付き期間 (labeled duration)、および時刻期間 (time duration) も参照。

偽グローバル・ロック競合 (false global lock

contention). 複数のロック名が同じ標識にハッシュされる場合、および実際の競合が存在しない場合のカップリング・ファシリティーからの競合指示。

揮発性表 (volatile table). 可能な場合常に SQL 操作が索引アクセスを選択する表。

基本 (principal). 別のエンティティーと確実に通信できるエンティティー。 Kerberos では、プリンシパルはKerberos レジストリー・データベース内の項目として表され、ユーザー、サーバー、コンピューターなどが含まれる。

基本キー (primary key). リレーショナル・データベースでは、表の定義の一部である、固有な非ヌル・キー。固有キーまたは基本キーを持たない表を親として定義することはできない。

基本述部 (basic predicate). 2 つの値を比較する述部。

基本順次アクセス方式 (basic sequential access method

(BSAM)). 順次アクセスもしくは直接アクセス装置のいずれかを用いて、データ・ブロックを連続して記憶または検索するアクセス方式。

基本ビュー (underlying view). 別の視点が直接的または間接的に定義されている視点。

基本表 (base table). (1) SQL CREATE TABLE ステートメントによって作成され、持続データを保持するための表。結果表 (result table) および一時表 (temporary

table) と比較。

(2) LOB 列定義が入っている表。実際の LOB 列データは、基本表と一緒には保管されない。基本表には、各行の行 ID と、その LOB 列のそれぞれについての標識列が含まれている。補助表 (auxiliary table) と比較。

基本表スペース (base table space). 基本表が入っている表スペース。

逆方向ログ・リカバリー (backward log recovery). 再始動処理の 4 番目と最終のフェーズであり、このフェーズで DB2 は、ログを逆方向にスキャンして、打ち切られたすべての変更に対して UNDO ログ・レコードを適用する。

用語集 485

|||

|||

||

キャストアウト (castout). 変更されたページをグループ・バッファー・プールからディスクに書き込む DB2

の処理。

キャストアウト所有者 (castout owner). 特定のページ・セットまたは区画をキャストアウトする責任を持つDB2 メンバー。

キャッシュ構造 (cache structure). シスプレックスのすべてのメンバーが使用できるデータを保管するカップリング・ファシリティー構造。 DB2 データ共用グループは、キャッシュ構造をグループ・バッファー・プールとして使用する。

行 ID (ROWID) (row identifier). 行を一意的に識別する値。この値は行と一緒に保管され、変更されることはない。

行 (row). 表における横方向のコンポーネント。行は一連の値からなり、この値は表の各列にある。

行位置アクセス (row-positionedaccess). 単一の FETCH

ステートメントから単一の行を検索できる能力。

共存 (coexistence). マイグレーション中に、同じデータ共用グループ内で 2 つのリリースが存在する期間。

共通サービス域 (common service area (CSA)). z/OS

では、すべてのアドレス・スペースによってアドレス可能なデータ域が入っている共通域の一部分。

行トリガー (row trigger). トリガー細分性 FOR EACH

ROW を指定して定義されたトリガー。

共用通信域 (shared communications area (SCA)). DB2

データ共用グループが DB2 間通信のために使用するカップリング・ファシリティーのリスト構造。

共用ロック (share lock). 並行して実行するアプリケーションによるデータの変更を防ぐロック。データを読み取ることはできる。排他ロック (exclusive lock) と比較。

行ロック (row lock). データの単一の行のロック。

許可 ID (authorization ID). DB2 との接続のために検証できるストリングで、それに対して 1 組の特権が許可されている。このストリングは、個人、組織集団、または職務を表すことができるが、DB2 はこれが何を表しているのかを判別できない。

許可プログラム機能 (Authorized program facility

(APF)). 制限付き機能の使用を許可されたプログラムの識別を許可する機能。

区切り ID (delimited identifier). 二重引用符 (") で囲まれた一連の文字。この文字の列は、英字とその後に続く 0 個または 1 個の文字からなり、文字のおのおのは英字、数字、または下線 (_) でなければならない。

区切りトークン (delimiter token). ストリング定数、区切り ID、演算記号、または DB2 構文図に示されている特殊文字。

区分化索引 (partitioningindex). 最も左端の列が表の区分化列になっている索引。索引のパーティション化の有無は問わない。

区分データ・セット (partitioned data set (PDS)). メンバーと呼ばれるパーティションに分割された、ディスク装置内のデータ・セット。それぞれの区画には、1 つのプログラム、プログラムの一部、またはデータを入れることができる。区分データ・セットという用語は、プログラム・ライブラリーと同義。

区分ページ・セット (partitioned page set). 区分表スペースまたは索引スペース。区分のスコープ内のみの、ヘッダー・ページ、スペース・マップ・ページ、データ・ページ、および索引ページ参照データ。

組み込み SQL (embedded SQL). アプリケーション・プログラムの中にコーディングされている SQL ステートメント。静的 SQL (static SQL) を参照。

組み込み関数 (built-in function). DB2 が提供する関数の 1 つ。ユーザー定義関数 (user-defined function) と比較。

組み込みデータ・タイプ (built-in data type). IBM が提供するデータ・タイプの 1 つ。DB2 UDB for z/OS

の組み込みデータ・タイプには、ストリング、数値、ROWID、および日時がある。特殊タイプ (distinct type)

と比較。

クライアント (client). リクエスター (requester) を参照。

位取り (scale). SQL において、小数点の右側の桁数(C 言語では精度と呼ばれる)。 DB2 ライブラリーではSQL 定義が使用される。

クラスタリング索引 (clustering index). 行が表スペース内でどのように物理的に配置されるか (クラスターされるか) を決定する索引。パーティション化された表上のクラスタリング索引が区分化索引ではない場合、行はスパンニング・パーティションではなく各データ・パーティション内にクラスター順に配置される。DB2 UDB

for z/OS V8 より前では、クラスタリング索引には区分化索引が必要であった。


||

クラス・ワード (class word). データ属性の性質を表す単一ワード。例えば、 PROJ というクラス・ワードは、属性がプロジェクトを識別することを示す。

グループ再始動 (group restart). ロックまたは共用連絡域が失われた後の、データ共用グループの少なくとも1 つのメンバーの再始動。

グループ名 (group name). データ共用グループの z/OS

XCF ID。

グループ・バッファー・プール (group buffer pool

(GBP)). データをキャッシュに入れ、すべてのメンバーでそのデータが確実に一貫性のあるようにするために、データ共用グループによって使用されるカップリング・ファシリティーのキャッシュ構造。

グループ・バッファー・プールの二重化 (group buffer

pool duplexing). データをグループ・バッファー・プール構造の 2 つのインスタンスである、1 次グループ・バッファー・プール (primary group buffer pool) と 2

次グループ・バッファー・プール (secondary group

buffer pool) に書き込む機能。 z/OS の資料では、これらのインスタンスを「旧」構造 (1 次の場合) および「新」構造 (2 次の場合) と表記している。

グループ・レベル (group level). 最初のメンバーが新しいリリースにマイグレーションするときに設定される、データ共用グループのリリース・レベル。

クレーム (claim). あるプロジェクトにアクセスされていることの DB2 への通知。クレームは、そのクレームが解放される (通常、コミット・ポイントで行われる)

まで、ドレーンが発生するのを防止する。ドレーン(drain) と比較。

クレーム・カウント (claim count). 1 つのオブジェクトをアクセスしているエージェントの数のカウント。

クレーム・クラス (claim class). 特定のオブジェクト・アクセスのタイプであり、以下の分離レベルのいずれかである場合がある。カーソル固定 (CS)

反復可能読み取り (RR)

書き込み

クローズされたアプリケーション (closed application).

特定の DB2 オブジェクトで特定のステートメントの排他使用を必要とするアプリケーション。それによって、そのオブジェクトはアプリケーションの外部インターフェースを介して単独で管理される。

グローバル・ロック (global lock). DB2 のサブシステム内およびサブシステム間の並行性制御を提供するロッ

ク。ロックの有効範囲は、データ共用グループのすべての DB2 サブシステムに渡っている。

グローバル・ロック競合 (global lock contention). データ共用グループの異なる DB2 メンバーが共用リソースの逐次化を試みている場合の、それらメンバー間のロッキング要求の対立。

クロスメモリー・リンケージ (cross-memory linkage).

異なるアドレス・スペースでプログラムを呼び出すための方式。この呼び出しは、呼び出し側に関して同期。

グロス・ロック (gross lock). 表、区画、または表スペース上の共用、更新、または排他モードのロック。

計画 (plan). アプリケーション計画 (application plan)

を参照。

計画セグメント化 (plan segmentation). おのおのの計画をセクションに分割。セクションが必要なとき、独立して EDM プールにもたらされる。

計画名 (plan name). アプリケーション計画の名前。

計画割り振り (plan allocation). 実行準備中の計画に、DB2 リソースを割り振る処理。

継承 (inheritance). クラス階層の親クラスから子クラスへ、クラス・リソースまたは属性のダウンストリームを渡すこと。

計測機能インターフェース (instrumentation facility

interface (IFI)). プログラムが、DB2 に関するオンライン・トレース・データを入手して DB2 コマンドを実行依頼し、データを DB2 に渡すことを可能にするプログラミング・インターフェース。

計測機能構成コンポーネント ID (instrumentation

facility component identifier(IFCID)). トレース可能なイベントのトレース・レコードに名前を付けて識別する値。 START TRACE コマンドおよび MODIFY TRACE

コマンドのパラメーターとして、対応するイベントをトレースすべきであることを指定する。

結果セット (result set). ストアード・プロシージャーがクライアント・アプリケーションに戻す行の集合。

結果セット・ロケーター (result set locator). ストアード・プロシージャーが戻す照会結果セットを固有に識別するために DB2 が使用する 4 バイトの値。

結果表 (result table). SELECT ステートメントによって指定される行の集合。

結合 (join). リレーショナル演算の 1 つ。突き合わせ列値を基準にして 2 つまたはそれ以上の表からデータ

用語集 487

を検索することを可能にする。 equijoin、全外部結合(full outer join)、内部結合 (inner join)、左方外部結合(left outer join)、外部結合 (outer join)、および右方外部結合 (right outer join) も参照。

結合 (union). 2 つの SELECT ステートメントの結果を結合する SQL 演算。結合は、複数の表から得た値のリストをマージするためによく使用される。

限界キー (limit key). 区画に対する索引キーの最も大きい値。

現行 SQL ID (current SQL ID). 特定のダイナミックSQL ステートメントを実行したときに行使される特権を保持する、単一時点での ID。現行 SQL ID は、1 次許可 ID または 2 次許可 ID のいずれかになる可能性がある。

現行状況再作成 (current status rebuild). ログ上の情報からサブシステムの状況の再構成が行われる、再始動処理の第 2 フェーズ。

現行データ (current data). ホスト構造内のデータであって、基本表内のデータと同じにされているもの。

検査済み (already verified). LU 6.2 セキュリティー・オプションの 1 つであり、会話を割り当てる際に、ユーザーの検査済み許可 ID を DB2 が提供できるようにするもの。このオプションで、ユーザーがパートナーのDB2 サブシステムによって妥当性検査されることはない。

検査制約 (check constraint). 基本表の特定の列に入れることができる値を指定するユーザー定義の制約。

コード化文字セット (coded character set). 文字セットを設定し、またセット内の文字とそのコード化表現との1 対 1 の関係を設定する明確な規則の集合。

コード化文字セット ID (coded character set identifier

(CCSID)). 漢字のコード化表現を一意に表す 16 ビットの数。これはエンコード・スキーマ ID を表すとともに、文字セット ID と関連コード・ページ ID の対(1 つまたは複数) を指定する。

コード点 (code point). CDRA において、コード・ページの文字を表す固有のビット・パターン。

コード・ページ (code page). (1) コード点に割り当てた文字の集合。例えば EBCDIC では、文字 'A' はコード・ポイント X'C1'に割り当てられ、 (2) 文字 'B' はコード・ポイント X'C2' に割り当てられる。コード・ページ内で、各コード・ポイントは、それぞれ 1 つの特定の意味だけを持つ。

コード・ユニット (code unit). 文字データを表すために使用されるコンピューター・アーキテクチャーでの基本 2 進数幅 (7 ビット、8 ビット、16 ビット、または32 ビットなど)。使用される文字エンコード形式に応じて、コード化文字セット内の各コード・ポイントは、1

つ以上のコード・ユニットによって内部的に表現できる。

コールド・スタート (cold start). どのログ・レコードも処理せずに DB2 を再始動させる処理。ウォーム・スタート (warm start) と比較。

コール・レベル・インターフェース (call level interface

(CLI)). データベース・アクセスへの呼び出し可能アプリケーション・プログラミング・インターフェース(API) の 1 つであり、組み込み SQL の代わりとして使用される。組み込み SQL と異なり、 DB2 ODBC (これは、CLI アーキテクチャーを基にしている) では、ユーザーがアプリケーションをプリコンパイルしたり、バインドする必要はないが、その代わり、実行時に SQL

ステートメントおよび関連するサービスを処理する関数の標準セットを提供している。

交渉可能ロック (negotiable lock). 競合するユーザー間の同意によって、自身のモードをすべてのユーザーと互換性を持つようダウングレードできるロック。物理ロックは、交渉可能ロックの 1 つ。

更新可能性 (updatability). 位置を指定した更新および削除を実行するためのカーソルの能力。カーソルの更新可能性は、SELECT ステートメントと、DECLARE

CURSOR ステートメントに指定したカーソル感度オプションによって影響される可能性がある。

更新トリガー (update trigger). トリガー SQL 操作である UPDATE を使用して定義されたトリガー。

構造 (structure). (1) 表、データベース、ビュー、索引、および表スペースなど、異なるタイプの DB2 オブジェクト全体のことを指す名前。(2) カップリング・ファシリティー上のストレージをマップして管理するために、 z/OS が使用する構成。キャッシュ構造 (cache

structure)、リスト構造 (list structure) またはロック構造 (lock structure) も参照。

構造化照会言語 (SQL) (Structured Query Language

(SQL)). リレーショナル・データベースのデータ定義および操作するための標準化言語。

構造所有者 (structure owner). グループ・バッファー・プールとの関係においては、以下のアクティビティーに対し責任にある DB2 メンバー。

v 再構築、チェックポイント、およびダメージ・アセスメント処理の調整。


#######

v グループ・バッファー・プールのしきい値のモニター、およびしきい値に達したときのキャストアウト所有者への通知。

構文文字セット (syntactic character set). 文字セット00640 として IBM レジストリーに登録されている 81

文字の図形文字の集合。システムおよび国境を超えて移植性および互換性を最大化するために、構文上の目的で、このセットをプログラム言語コミュニティーで使用することを当初から推奨している。このセットには、いくつかの例外を除いて、ほとんどが 1 次登録済み文字セットに含まれている。不変文字セット (invariant

character set) も参照。

国際化対応 (internationalization). 多くの異なる地域および言語からの文字のコード・ポイントを表すことができる、エンコード・スキームに対するサポート。すべての地域をサポートするためには、ユニコード規格では、単一の文字を 2 バイト以上で表すことが必要である。ユニコード (Unicode) も参照。

国際標準化機構 (International Organization

forStandardization). 知的、科学、テクノロジー、および経済における協力活動ほか、財およびサービスのやりとりを容易にするための標準を確立していく国際機関。

コスト・カテゴリー (cost category). ステートメントのバインド時に、DB2 が SQL ステートメントについてのコスト見積もりを入れるカテゴリー。コスト見積もりは、以下のコスト・カテゴリーのいずれかに入れることができる。v A: DB2 がデフォルト値を使用せずにコスト見積もりを行うのに十分な情報を持っていることを示す。

v B: DB2 が見積もりのためにデフォルト値の使用を強制される条件が存在することを示す。

コスト・カテゴリーは、ステートメントの Explain 時にDSN_STATEMNT_TABLE の COST_CATEGORY 列で外部化される。

固定長ストリング (fixed-length string). その長さが特定されていて、変更できない文字または漢字のストリング。可変長ストリング (varying-length string) と比較。

コピー・ターゲット (copy target). コピー・プール・ボリューム・コピーのコンテナーとして使用されるSMS ストレージ・グループの、名前の付いたセット。コピー・ターゲットは、 FlashCopy 機能を使用してコンテナーとしてどのストレージ・グループを使用するかを定義できる SMS 構造である。

コピー・バージョン (copy version). HSM が管理する、ポイント・イン・タイム FlashCopy コピー。各プー

ル・コピーには、ディスク上でいくつのコピー・バージョンを保守するかを指定するバージョン・パラメーターがある。

コピー・プール (copy pool). 一括コピーされたデータを含む SMS ストレージ・グループの、名前の付いたセット。コピー・プールは、FlashCopy 機能を使用してどのストレージ・グループをコピーするかを定義できるSMS 構造である。HSM はどのボリュームがコピー・プールに属するのかを決定する。

コマンド (command). DB2 オペレーター・コマンドまたは DSN サブコマンド。コマンドは、SQL ステートメントとは異なる。

コマンド接頭部 (command prefix). 1 ～ 8 文字のコマンド ID。コマンド接頭部によって、コマンドが MVS

ではなくアプリケーションまたはサブシステムに属していることが見分けられる。

コマンド認識文字 (command recognition character

(CRC)). z/OS コンソール・オペレーターまたは IMS

サブシステム・ユーザーが、特定の DB2 サブシステムに DB2 コマンドを送る場合に使用できる文字。

コマンド有効範囲 (command scope). データ共用グループのコマンド操作の有効範囲。コマンドがメンバー有効範囲を持っている場合、そのコマンドは、1 人のメンバーからの情報だけを表示するか、またはそのメンバーがローカルに所有する非共用リソースだけに影響を与える。コマンドがグループ有効範囲を持っている場合、そのコマンドは、すべてのメンバーからの情報を表示するか、すべてのメンバーがローカルに所有する非共用リソースに影響を与えるか、共用可能リソースに関する情報を表示するか、または共用可能リソースに影響を与える。

コミット (commit). ロックを解除することで作業単位を終了し、その作業単位によって行われたデータベースの変更を他の処理が認識できるようにする操作。

コミットされたフェーズ (committed phase). マルチサイト更新処理の 2 番目のフェーズであり、すべての参加プログラムが作業論理単位の効果をコミットするように要求する。

コミット中 (in-commit). リカバリー単位の状況。 DB2

がそのフェーズ 2 のコミット処理を開始した後に障害を起こした場合、再始動したときにデータに加えられた変更に整合性があることを DB2 は「認識」している。このようなリカバリー単位は、コミット中と呼ばれる。

コミット点 (commit point). データに整合性があると見なされる時点。

用語集 489

||||

||||||

||

|||

||||||

コレクション (collection). 同じ修飾子を持つパッケージのグループ。

子ロック (child lock). 明示的階層ロッキングに対し、表、ページ、行またはラージ・オブジェクト (LOB) のいずれかで行われるロック。各子ロックには親ロックがある。親ロック (parent lock) も参照。

混合データ・ストリング (mixed data string). 1 バイト文字と 2 バイト文字をどちらも入れることができる文字ストリングのこと。

コンテキスト (context). データ・ソースおよび関連する内部 DB2 ODBC 接続情報へのアプリケーションの論理接続。これにより、アプリケーションはその操作をデータ・ソースに指示することができる。 DB2 ODBC コンテキストは、DB2 スレッドを表す。

コントロール・インターバル定義フィールド (control

interval definition field(CIDF)). VSAM においては、各制御インターバルの終わりの 4 バイトにあるフィールド。このフィールドは、制御インターバル内にフリー・スペースがある場合に、それを記述する。

［サ行］サーバー (server). リモート・リクエスターからの要求のターゲット。 DB2 環境においては、サーバー機能はリモート・アプリケーションから DB2 へアクセスするために使用する分散データ機能により提供される。

サーバー・サイド・プログラミング(server-sideprogramming). DB2 データを動的 Web ページに追加するための 1 つの方法。

サービス要求ブロック (service request block). 別のアドレス・スペース内で実行するようにスケジュールされた作業の単位。

サービス・クラス (class of service). ネットワークを介する経路のリスト (経路を使用する優先順序で配置されている) に対する VTAM 用語。

サービス・クラス (service class). z/OS ワークロード・マネージャーが使用する 8 文字の ID。これにより、ユーザー・パフォーマンスのゴールを特定の DDF

スレッドまたはストアード・プロシージャーに関連付ける。サービス・クラスは、並列処理アシスタントでの作業をクラス分けするためにも使用される。

サイクル (cycle). 各表がその前の表の下層となり、最初の表が最後の表の下層となるように順序付けできる一組の表。自己参照表は、単一メンバーの場合のサイクルである。

再実行 (redo). リカバリー単位の 1 つの状態であり、データ保全性を確保するためにディスク・メディアに変更を再度適用すべきであることを示す。

再実行検出メカニズム (replay detection mechanism).

要求が承認できる発信元からの有効な要求かどうか、または信頼できないエンティティーが以前の交換から情報を入手し、プリンシパルにアクセスするために情報交換を再実行しているのかどうかを、そのプリンシパルが検出できるようにする方式。

再始動ペンディング (restart pending (RESTP)). ページ・セットまたは区画の限定的な状態であり、そのオブジェクトについて再始動 (バックアウト) 作業を実行する必要があることを示す。そのページ・セットまたは区画に対するすべてのアクセスは、以下によるアクセスを除き拒否される。v RECOVER POSTPONED コマンドv 自動オンライン・バックアウト (これは、システム・パラメーター LBACKOUT=AUTO) で再始動した後にDB2 が呼び出す。

最終エージェント最適化 (last agent optimization). 推定ナッシング・プロトコル、または推定打ち切りプロトコルのコミット・フローの最適化。最終エージェントまたは最終参加プログラムがコミット調整プログラムになる。このフローは、少なくとも 1 つのメッセージを保管する。

最新表示経過時間 (refresh age). 現在の時間とマテリアライズ照会表が最後に最新表示された時間の間の経過時間。

サイズ (size). C 言語において、10 進数での合計の桁数 (SQL では精度と呼ばれる)。 DB2 ライブラリーはSQL 条件を使用する。

最適化 (reoptimization). 実行時に SQL ステートメントのアクセス・パスを再検討する DB2 処理。再最適化時に DB2 は、ホスト変数、パラメーター・マーカー、または特殊レジスターの値を使用する。

再入可能 (reentrant). ストレージ内に全スレッドについての 1 つのコピーとして常駐することができる実行可能コード。再入可能コードは、自己修飾されず、各スレッドごとに別々のストレージを提供する。再入可能性は、コンパイラーおよびオペレーティング・システム上の概念であり、再入可能性だけでは、マルチスレッド化の結果を論理的に矛盾のないものするには不十分である。 threadsafe も参照。

再バインド (rebind). 以前にバインドされたアプリケーション・プログラムに対する新しいアプリケーション・プランを作成すること。例えば、アプリケーションがア


||||

|||

クセスする表に索引を追加した場合、その索引を利用するにはアプリケーションを再バインドしなければならない。

再ビルド (rebuild). カップリング・ファシリティー構造の再割り振り処理。共用連絡域 (SCA) およびロック構造では、構造は再移植される。グループ・バッファー・プールでは、通常、変更されたページがディスクにキャストアウトされ、新しい構造と一緒に移植されるのは、変更されたページのうち正常にキャストアウトされなかったもののみとなる。

再マイグレーション (remigration). DB2 の直前のリリースにフォールバックしたあと、現行リリースに戻る処理。このプロシージャーは、別のマイグレーション・プロセスを構成する。

サインオン (sign-on). 個々の CICS または IMS アプリケーションの処理のために接続機能が行う要求であり、これにより DB2 リソースを使用することが許可されているかを DB2 が検証できる。

作業単位 (unit of work). アプリケーション処理におけるリカバリー可能な一連の操作。アプリケーション処理は、常に単一の作業単位であるが、コミットまたはロールバック操作のため、アプリケーション処理全体には複数の作業単位が関係する。マルチサイト更新操作では、単一の作業単位に複数のリカバリー単位を含めることができる。リカバリー単位 (unit of recovery) と比較。

作業論理単位 (logical unit of work identifier

(LUWID)). ネットワーク内のスレッドを個別に識別する名前。この名前は、完全修飾 LU ネットワーク名、LUW インスタンス番号、および LUW 順序番号から構成される。

作業論理単位 (logical unit of work (LUW)). プログラムが同期点と同期点の間で行う処理。

索引 (index). キーの値によって論理的に配列されたポインターのセット。索引を用いるとデータへのアクセスが速くなり、表の行の一意性を強めることができる。

索引キー (index key). ある表において、索引項目の順序を判断するために使用される列のセット。

索引スペース (index space). 1 つの索引の項目を保管するために使用されるページ・セット。

索引制御区分化 (index-controlledpartitioning). パーティション化された表のパーティション境界が、CREATE

INDEX ステートメント上に指定された値によって制御

される区分化のタイプ。パーティション境界は、SYSIBM.SYSINDEXPART カタログ表の LIMITKEY 列上に保管される。

索引パーティション (index partition). 区分化索引スペース内に含まれている VSAM データ・セット。

削除規則 (delete rule). 親行が削除されたときに、従属行に対して行う処理を DB2 に通知する規則。各関係についての規則は CASCADE、RESTRICT、SET NULL、または NO ACTION が可能です。

削除トリガー (delete trigger). トリガー SQL 操作である DELETE を使用して定義されたトリガー。

削除ホール (delete hole). 結果表内の行の再フェッチが行われたが、その行が基本表に存在していないときにカーソルが位置付けられる位置。これは、カーソルが最初に結果表にその行を組み込んでから、カーソルがその行の再フェッチを試みるまでの間に、別のカーソルがその行を削除してしまったためである。

削除ホール (update hole). 結果表内の行が再びフェッチされ、新規値が検索条件を満たさなくなった場合に、カーソルが置かれる位置。データベース内の行の更新により、行が結果表に対し不適となった場合、DB2 は結果表内に削除ホールとして該当行をマークする。

作成済みの一時表 (created temporary table). 一時データを保持し、SQL ステートメント CREATE GLOBAL

TEMPORARY TABLE を使用して定義される表。作成済みの一時表 (created temporary table) に関する情報はDB2 カタログに保管されるので、こうした表は永続的であり複数のアプリケーション・プロセスで共用できる。宣言済み一時表 (Declared temporary table) と比較。一時表 (temporary table) も参照。

作動不能パッケージ (inoperative package). パッケージが従属している 1 つまたは複数のユーザー定義関数またはプロシージャーが取り除かれているために使用できないパッケージ。このようなパッケージは、明示的に再バインドする必要がある。無効パッケージ (invalid

package) と比較。

サブコンポーネント (subcomponent). 一般機能を提供するため一緒になって作業する最も関連した DB2 モジュールのグループ。

サブジェクト表 (subject table). 作成されるトリガーの対象である表。定義されたトリガー・イベントがこの表で発生すると、トリガーがアクティブになる。

サブシステム (subsystem). リレーショナル・データベース管理システム (RDBMS) の別個のインスタンス。

用語集 491

|||

|||

サブページ (subpage). 物理的索引ページを分割できる単位。

サロゲート・ペア (surrogate pair). 2 つの 16 ビット・コード単位のシーケンスから成る単一文字のためのコード化表現。このペアの最初の値は U+D800 ～U+DBFF の高位サロゲート・コード・ユニットで、2 番目の値は U+DC00 ～ U+DFFF の低位サロゲート・コード・ユニットである。サロゲート・ペアは、32 ビット文字を使用せずに 917 476 文字をエンコードするための拡張メカニズムを提供する。

参加プログラム (participant). コミット処理に参加するコミット調整プログラム以外のエンティティー。 SNA

では、参加プログラム (participant) という用語は、エージェント (agent) と同義。

参照構造 (referential structure). 少なくとも 1 つの表を含む表およびリレーションの集合。その集合の各表について、表が参加するすべてのリレーションおよび関連するすべての表。

参照制約 (referential constraint). 指定の外部キーの非ヌル値が、指定の表の基本キーの値に等しい場合のみ有効であることが必要とされること。

参照保全 (referential integrity). すべての外部キーのすべての値が有効であるデータベースの状態。参照保全を維持するには、参照制約が定義されている表内のデータを変更するすべての操作に対して、参照制約の強制が必要である。

シーケンス (sequence). ユーザーの仕様に従い数値のシーケンスを生成するユーザー定義オブジェクト。

式 (expression). 1 つの値を生み出す 1 つのオペランド、または演算子とオペランドの集合。

識別 (identify). DB2 とは別のアドレス・スペース内の接続サービス・プログラムが、z/OS サブシステム・インターフェースを介して発行するもので、 DB2 に自身の存在を通知し、DB2 への接続開始処理を要求する。

識別列 (identity column). 各行の数値を自動的に生成する方法を DB2 に提供する列。循環が使用されていなければ、生成された値は固有なものとなる。識別列は、AS IDENTITY 文節を使用して定義される。 ID 列のみを含むユニーク索引を定義することで、値の固有性が保証される。 1 つの表では、1 つの識別列しか持つことができない。

時刻 (time). 時刻を時、分、秒で示す 3 つの部分からなる値。

時刻期間 (time duration). 時間数、分数、および秒数を表す 10 進整数。

自己参照制約 (self-referencing constraint). 表がそれ自体従属である関連を定義する参照制約。

自己参照表 (self-referencing table). 自己参照制約がある表。

事後トリガー (after trigger). トリガー起動時間AFTER で定義されているトリガー。

システム会話 (system conversation). 分散処理を開始する前にシステム・メッセージを処理するため、2 つのDB2 サブシステムが確立しておかなければならない会話。

システム間拡張サービス (cross-system extended

services(XES)). z/OS サービスの集合であり、これによりアプリケーションまたはサブシステムの複数のインスタンスが、シスプレックス環境内の異なるシステム上で実行され、カップリング・ファシリティーを使って高性能、高可用性データ共用を実現することができる。

システム管理者 (system administrator). コンピューター・システムの使用を設計、制御、および管理する、コンピューターのインストール先の担当者。

システム共通カップリング・ファシリティー(cross-system coupling facility (XCF)). シスプレックス内で実行されている許可プログラム間で、互いに協調できるようにする機能を提供する z/OS のコンポーネント。

システム指定接続 (system-directed connection). 3 パート名を指定した SQL ステートメントを処理することによってリレーショナル DBMS が管理する接続。

システム診断作業域 (system diagnostic work area

(SDWA)). プログラムまたはハードウェア・エラーを記述する SYS1.LOGREC 項目に記録されるデータ。

システム・エージェント (system agent). プリフェッチ処理、据え置き書き出し、およびサービス・タスクなどの DB2 が内部で作成する作業要求。

システム・ネットワーク体系 (Systems Network

Architecture (SNA)). ネットワークの構成ならびに操作による情報の伝送およびその制御を行う場合の、論理構造、フォーマット、プロトコル、および操作手順の記述。


||

シスプレックス照会並列処理 (Sysplex query

parallelism). 複数の DB2 サブシステム上で複数のタスクを使用することで完了する、単一の照会の並列実行。照会 CP 並列処理 (query CP parallelism) も参照。

事前様式設定 (preformat). 特定のデータ・パターンを書き込むことによって、VSAM ESDS を DB2 が使用するために準備する処理。

実行可能ステートメント (executable statement). アプリケーション・プログラムに組み込まれる SQL ステートメント。ダイナミックに準備され実行されるか、対話式に出される。

実行コンテキスト (execution context). SQLJ では、SQL ステートメントの実行の制御に使用できる Java™

オブジェクト。

自動照会再書き込み (automatic queryrewrite). 基本表を参照する SQL ステートメントを検査し、適切な場合、照会を再書き込みするプロセス。これによりパフォーマンスが向上する。このプロセスでは照会を再書き込みするか判別でき、ソース表から得た 1 つ以上のマテリアライズ照会表を参照する。

シフトアウト文字 (shift-out character). EBCDIC システムで使用される特殊な制御文字 (X'0E') であり、これ以降のバイトから次のシフトイン文字までが DBCS 文字であることを表す。シフトイン文字 (shift-in

character) も参照。

シフトイン文字 (shift-in character). EBCDIC システムで使用される特殊な制御文字 (X'0F') であり、これ以降のバイトが SBCS 文字であることを表す。シフトアウト文字 (shift-out character) も参照。

従属 (dependent). 少なくとも 1 つの親を持つオブジェクト (行、表、または表スペース)。オブジェクトは、その親の従属 (行、表、もしくは表スペース) ともいわれる。親行 (parent row) 、親表 (parent table) 、親表スペース (parent table space) も参照。

従属行 (dependent row). 親行の基本キーの値に等しい外部キーが入っている行。

従属表 (dependent table). 少なくとも 1 つの参照制約において従属である表。

集約関数 (aggregate function). 1 つまたは複数の行からの値を使用して、その結果を引き出す演算操作。スカラー関数 (scalar function) と比較。

縮小変換 (contracting conversion). 変換されたストリングがソース・ストリングよりも短い場合に発生する処理。例えば、この処理は、DBCS 文字が入った EBCDIC

混合データ・ストリングが ASCII 混合データに変換されるときに発生する。シフト・コードが除去されるため、変換されたストリングの方が短くなる。

述部 (predicate). 比較演算を表すか、あるいはそれを暗黙に指定する探索条件のエレメント。

順次カーソル (serial cursor). 順方向にのみ移動できるカーソル。

順次事前取り出し (sequential prefetch). 連続的な非同期入出力操作をトリガーするメカニズム。ページは必要になる前にフェッチされ、いくつかのページは一回の入出力操作で読み取られる。

順次データ・セット (sequential data set). 磁気テープ上のような、連続した物理位置に基づいてレコードの編成が行われる、非 DB2 データ・セット。 DB2 データベース・ユーティリティーには、順次データ・セットを必要とするものがいくつかある。

準備 (prepare). 2 フェーズ・コミットの第 1 フェーズで、すべての参加プログラムがコミットの準備を要求される。

準備済み SQL ステートメント (prepared SQL

statement). PREPARE ステートメントによって処理される SQL ステートメントの実行可能形式である名前付きのオブジェクト。

順方向カーソル (nonscrollable cursor). 順方向にのみ移動できるカーソル。スクロール不能カーソルは、前方スクロール・カーソルまたは順次カーソルとも呼ばれる。

順方向ログ・リカバリー (forward log recovery). DB2

がログを順方向に処理し、すべての REDO ログ・レコードを用いる、再始動処理の第 3 フェーズ。

照会 CP 並列処理 (query CP parallelism). 複数のタスクを使用して実行される単一の照会の並列実行。シスプレックス照会並列処理 (sysplex query parallelism) も参照。

照会 (query). 結果表を指定する特定の SQL ステートメントのコンポーネント。

照会入出力並列処理 (query I/O parallelism). 単一の照会内で複数の入出力要求をトリガーにして行われるデータの並列アクセス。

照会ブロック (query block). FROM 文節の 1 つによって表される照会の一部。 DB2 による照会の内部処理によっては、各 FROM 文節ごとに複数の照会ブロックが存在することもある。

用語集 493

###

障害メンバー状態 (failed member state). データ共用グループのメンバーの状態。あるメンバーに障害が起こると、XCF は障害が起こったメンバーの状態を永続的に記録する。通常、この状態は、状態がアクティブから静止に変更される前に、そのメンバーのタスク、アドレス・スペース、または z/OS システムが終了したことを意味する。

条件再始動 (conditional restart). ユーザー定義の条件付き再始動制御レコード (CRCR) により指示されるDB2 の再始動。

私用接続 (private connection). DB2 に特有の通信接続。

初期設定ファイル (initialization file). DB2 ODBC アプリケーションでは、データベース・マネージャーのパフォーマンスを調整するように設定できる値を含むファイル。

ジョブ制御言語 (JCL). オペレーティング・システムでジョブを識別するため、およびそのジョブの要件を記述するために使用される制御言語。

ジョブ入力サブシステム (JES). システムでジョブを受け取り、そのジョブによって生成されたすべての出力データを処理する、IBM ライセンス・プログラム。

処理待ち (to-do). リカバリー単位の状態。リカバリー可能 DB2 リソースに行ったリカバリー単位の変更が未確定であり、コミット調整プログラムの判断に従って、その変更をディスク・メディアに適用するかロールバックする必要があることを示している。

シリアライズ・プロファイル (serialized profile). SQL

ステートメントとホスト変数の記述が入っている Java

オブジェクト。SQLJ 変換プログラムは、各接続コンテキストごとに直列化プロファイルを作成する。

推定アボート (presumed-abort). ナッシングと推定される 2 フェーズ・コミット・プロトコルの最適化。これにより、リカバリー・ログ・レコードの数、状態保守の期間、および調整プログラムと参加プログラム間のメッセージの数が軽減される。また、最適化により未確定解決職責が変更される。

推定ナッシング (presumed-nothing). 作業論理単位の状態、リカバリー・ログ、未確定解決に関連する、調整プログラムと参加プログラムの責任範囲を定義する標準的な 2 フェーズ・コミット・プロトコル。

据え置き書き出し (deferred write). 変更済みのデータ・ページをディスクに非同期に書き込む処理。

据え置き組み込み SQL (deferred embedded SQL). 完全に静的でも、完全にダイナミックでもない SQL ステートメント。静的ステートメントのように、アプリケーション内に組み込まれるが、ダイナミック・ステートメントのように、アプリケーションの実行中に準備されるステートメント。

スカラー関数 (scalar function). 別の値から単一の値を作成する SQL 操作であり、関数名として表され、その後に括弧に囲まれた引数のリストが続く。集約関数(aggregate function) と比較。

スキーマ (schema). (1) データベースの編成または構造。(2) ユーザー定義関数、特殊タイプ、トリガー、およびストアード・プロシージャーのための論理的なグループ分け。これらのタイプのうちの 1 つのタイプのオブジェクトが作成されると、そのオブジェクトは、そのオブジェクトの名前によって決定された 1 つのスキーマに割り当てられる。例えば、次のステートメントは、スキーマ C に特殊タイプ T を作成する。

CREATE DISTINCT TYPE C.T ...

スクロール可能カーソル (scrollable cursor). 順方向と逆方向の両方に移動できるカーソル。

スクロール可能性 (scrollability). カーソルを使用して、順方向または逆方向にフェッチするための機能。FETCH ステートメントは、カーソルの新しい位置を指示するために、複数のフェッチ方向をサポートする。フェッチ方向 (fetch orientation) も参照。

スター型結合 (star join). ファクト表のディメンション列と、対応するディメンション表のキー欄とを結合するための方式。結合 (join)、ディメンション (dimension)、およびスタースキーマ (star schema) も参照。

スタースキーマ (star schema). ファクト表 (ほとんどのデータが含まれる) といくつかのディメンション表を組み合わせたもの。スター型結合 (star join)、ディメンション (dimension)、およびディメンション表 (dimension

table) も参照。

ステートメント・ストリング (statement string). ダイナミック SQL ステートメントでは、ステートメントの文字ストリング書式。

ステートメント・トリガー (statement trigger). トリガー細分性 FOR EACH STATEMENT を指定して定義されたトリガー。

ステートメント・ハンドル (statement handle). DB2

ODBC では、DB2 ODBC によって管理される SQL ステートメントに関する情報が入っているデータ・オブジェクト。これには、ダイナミック引数、ダイナミック引


####

||||||||

|

数と列のバインディング、カーソル情報、結果の値、および状況情報などが含まれる。各ステートメント・ハンドルは接続ハンドルに関連付けられる。

ストリング (string). 文字ストリング (character string)

または漢字ストリング (graphic string) を参照。

ストレージ・グループ (storage group). DB2 データを格納できる名前付きのディスクのセット。

スペース (space). 1 つまたは複数のブランク文字。

スレッド (thread). アプリケーションの接続を記述し、その過程をトレースしてリソース機能を処理し、さらにその DB2 リソースとサービスへのアクセス可能性の範囲を定める DB2 構造。ほとんどの DB2 機能はスレッド構造下で実行される。接続スレッド (allied thread) およびデータベース・アクセス・スレッド (database

access thread) も参照。

スレッド・セーフ (threadsafe). 各スレッド用に専用ストレージを提供することと、共用 (グローバル) ストレージ域を適正に直列化することの両方によって、マルチスレッド化を可能にするコードの特性。

セーブポイント (savepoint). 作業単位内の特定の点におけるデータおよびスキーマの状態を表す名前付きのエンティティー。セーブポイントの設定、セーブポイントの解放、およびセーブポイントが表す状態へのデータとスキーマの復元を行う SQL ステートメントが存在する。通常、データおよびスキーマをセーブポイントに修復することを、セーブポイントへのロールバックと呼ぶ。

正規化 (normalization). 論理リレーショナル・データベースの設計を行う作業における主要なステップの 1

つ。正規化は、データの冗長と不整合を回避するのに役立つ。あるエンティティーは、特定の正規形 (第 1 正規形、第 2 正規形など) に対する 1 組の制約に合致すると正規化される。非正規化 (denormalization) と比較。

制御インターバル (control interval (CI)). VSAM がレコードを保管し、分散フリー・スペースを作成する、固定長域またはディスク。キー順データ・セットまたはファイルにおいて、シーケンス・セット・レコード内の項目が指すレコード・セット。制御インターバルは、VSAM がディスクとやりとりする情報の単位である。制御インターバルには、常に整数の物理レコード数が含まれる。

整合性トークン (consistency token). アプリケーションのバージョン ID を生成するために使用されるタイム・スタンプ。版 (version) も参照。

整合点 (point of consistency). アプリケーションがアクセスするすべてのリカバリー可能データが、他のデータと整合する時点。一貫性ポイント (point of consistency)

という用語は、同期点 (sync point) またはコミット・ポイント (commit point) と同義。

静止ポイント (quiesce point). DB2 QUIESCE ユーティリティーを実行した結果、データが整合する点。

静止メンバー状態 (quiesced member state). データ共用グループのメンバーの状態。STOP DB2 コマンドが失敗することなく有効になると、アクティブ・メンバーは静止する。コマンドが有効になる前にメンバーのタスク、アドレス・スペースまたは z/OS システムが失敗すると、メンバーの状態が失敗する。

静的 SQL (static SQL). プログラム内に組み込まれ、プログラム準備処理中に (プログラムの実行前に) 準備される SQL ステートメント。準備された後、このSQL ステートメントは変わらない (ステートメントによって指定されたホスト変数の値は変わることはある)。

静的カーソル (static cursor). アプリケーションがカーソルを開いた後も、結果表のサイズまたはその行の順番を変更しない、名前の付いた制御構造。動的カーソル(dynamic cursor) と比較。

精度 (precision). SQL では、10 進数で表される桁の合計数 (C 言語ではサイズと呼ばれる)。 C 言語では、小数点の右側の桁数 (SQL では位取りと呼ばれる)。DB2 ライブラリーでは、SQL 条件が使用される。

制約 (constraint). 表に対して挿入、削除、または更新ができる値を制限する規則。参照制約 (referential

constraint)、検査制約 (check constraint)、および固有制約 (unique constraint) を参照。

セクション (section). 単一の SQL ステートメントについての実行可能な構造体が含まれているプランまたはパッケージのセグメント。ほとんどの SQL ステートメントでは、ソース・プログラム内の各 SQL ステートメントごとに、プランに 1 つのセクションがある。ただし、カーソルに関係するステートメントの場合、DECLARE、OPEN、FETCH、および CLOSE の各ステートメントは、それぞれが DECLARE CURSOR ステートメントで名前が指定された SELECT ステートメントを参照するため、同一のセクションを参照する。COMMIT、ROLLBACK などの SQL ステートメント、および一部の SET ステートメントでは、セクションは使用されない。

セグメント (segment). 単一の表の行を保持するページのグループ。セグメント表スペース (segmented table

space) も参照。

用語集 495

||||

セグメント表スペース (segmented table space). セグメントと呼ばれる同一サイズのページのグループに分けられた表スペース。セグメントの表への割り当ては、異なる表の行が、同じセグメントに保管されないように行われる。

セッション (session). VTAM ネットワーク内の 2 つのノード間のリンク。

セッション・プロトコル (session protocols). SNA 通信要求および応答で使用できるセット。

接続 (connection). SNA においては、パートナーとなる 2 つの LU 間に通信パスが存在して、情報をやりとりすることができること (例えば、2 つの DB2 サブシステムが接続され、会話を通して通信する)。

接続 ID (connection ID). 接続機能によって提供され、特定のアドレス・スペース接続に関連する ID。

接続コンテキスト (connection context). SQLJ においては、データ・ソースへの接続を表す Java オブジェクト。

接続宣言文節 (connection declaration clause). SQLJ において、データ・ソースへの接続を宣言するステートメント。

接続ハンドル (connection handle). DB2 ODBC が管理する接続に関連した情報が入っているデータ・オブジェクト。これには、一般の状況情報、トランザクションの状況、および診断情報が含まれる。

接頭部 (prefix). メッセージまたはレコードの開始のコード。

全外部結合 (full outer join). 結合されている両方の表の一致した行が入っており、両方の表の不一致の行を保存する、結合操作の結果。結合 (join) も参照。

線形データ・セット (linear data set (LDS)). データを含むが、制御情報は含まない、VSAM データ・セット。仮想記憶域において線形データ・セットは、バイト・アドレス可能ストリングとしてアクセスできる。

宣言済み一時表 (Declared temporary table). 一時データを保持し、SQL ステートメント DECLARE GLOBAL

TEMPORARY TABLE を使用して定義される表。宣言済み一時表 (Declared temporary table) に関する情報はDB2 カタログに保管されないので、こうした表に永続性はなく DECLARE ステートメントを発行したアプリケーション・プロセスのみが使用できる。作成済みの一時表 (created temporary table) と比較。一時表(temporary table) も参照。

宣言生成プログラム (declarations generator

(DCLGEN)). SQL 表宣言、ならびにその表に従ったCOBOL、C、または PL/I データ構造宣言を生成する、DB2 のサブコンポーネント。宣言の生成は、DB2 システム・カタログから行われる。DCLGEN も DSN サブコマンドである。

全選択 (fullselect). 1 つの副選択、1 つの値文節、あるいはその両方のいくつかを演算子で結合したもの。全選択 (fullselect) は結果表を指定する。 UNION が使用されていない場合、全選択の結果は、指定された副選択の結果となる。

ソース関数 (sourced function). すでにデータベース・マネージャーに認識されている、別の組み込み関数またはユーザー定義関数によってインプリメントされた関数。この関数は、スカラー関数でも列 (集合体) 関数でもよく、値の集合から 1 つの値 (例えば、MAX またはAVG) を戻す。組み込み関数 (built-in function)、外部関数 (external function)、および SQL 関数 (SQL

function) と比較。

ソース表 (source table). 基本表、ビュー、表式、またはユーザー定義表関数になり得る表。

ソース・タイプ (source type). DB2 が内部的に特殊タイプを表すために使用する既存のタイプ。

ソース・プログラム (source program). SQL プリコンパイラーによって処理されるホスト言語ステートメントおよび SQL ステートメントのセット。

相関 ID (correlation ID). 特定のスレッドに関連するID。これは、TSO の場合は許可 ID かジョブ名。

相関副照会 (correlated subquery). 外側の副選択ステートメントで指定された表または視点の行または行グループに適用される副照会 (WHERE または HAVING 文節の一部)。

相関名 (correlation name). 1 つの SQL ステートメントの中で、表、視点、またはこれらの個々の行を示すID。これは、FROM 文節で定義することも、UPDATE

または DELETE ステートメントの最初の文節で定義することもできる。

相関列 (correlated columns). 1 つの列の値ともう 1

つの列の値の関係。

相対バイト・アドレス (relative byte address (RBA)).

データ・セットまたはそれが属するファイルに割り振られたストレージ・スペースの先頭からの、データ・レコードもしくは制御インターバルのオフセット。


||

挿入トリガー (insert trigger). トリガー SQL 操作である INSERT を使用して定義されたトリガー。

属性 (attribute). エンティティーが持つ特性。例えば、データベース設計において、従業員の電話番号はその従業員の属性の 1 つである。

ソケット (socket). 呼び出し可能 TCP/IP プログラミング・インターフェース。 TCP/IP ネットワーク・アプリケーションがリモート TCP/IP パートナーと通信するために使用する。

［タ行］待機順次アクセス方式 (queued sequential access

method (QSAM)). 基本順次アクセス方式 (BSAM) の拡張バージョン。この方式が使用されると、データ・ブロックのキューが形成される。入力データ・ブロックは処理されるのを待機し、出力データ・ブロックは補助ストレージまたは出力装置に転送されるのを待機する。

タイプ 1 索引 (type 1 indexes). DB2 バージョン 4 より前のリリースの DB2 で作成された、またはバージョン 4 でタイプ 1 索引と指定されている索引。タイプ 2

索引と比較。バージョン 8 以降、タイプ 1 の索引はサポートされなくなる。

タイプ 2 索引 (type 2 indexes). バージョン 7 より後の DB2 で作成される索引、またはバージョン 4 以降でタイプ 2 として指定される索引。

タイプ付きパラメーター・マーカー (typed parameter

marker). ターゲット・データ・タイプと一緒に指定されるパラメーター・マーカー。一般的には、次の形式である。

CAST(? AS data-type)

タイプなしパラメーター・マーカー (untyped parameter

marker). ターゲット・データ・タイプを付けずに指定されるパラメーター・マーカー。形式は 1 つの疑問符(?) である。

タイムアウト (timeout). DB2 サブシステムとアプリケーションのどちらかが、リソースの不可能な選択のため異常終了すること。インストール時の指定では、 DB2

が始動後に IRLM サービスを待機する時間と、アプリケーションが要求するリソースが使用可能でない場合にIRLM が待機する時間との両方を判断して設定される。これらの時刻指定のどちらかを超過すると、タイムアウトが宣言される。

タイム・スタンプ (timestamp). 日付と時刻を構成する、7 つの部分からなる値。タイム・スタンプは、年、月、日、時、分、秒、およびマイクロ秒で表される。

対話式システム生産性向上機能 (Interactive System

Productivity Facility (ISPF)). z/OS 環境で、対話式ダイアログ・サービスを提供する IBM ライセンス・プログラム。

ダウンストリーム (downstream). 同期点ツリーのノードの集合。 2 フェーズ・コミットの実行の参加プログラムとして、ローカル DBMS に接続される。

多次元分析 (multidimensional analysis). 1 つの企業を複数のレベルで査定および評価する処理。

多重仮想記憶 (Multiple Virtual Storage). z/OS オペレーティング・システムのエレメント。エレメントは基本制御プログラム (BCP) とも呼ばれる。

多重定義関数 (overloaded function). 複数の関数インスタンスが存在する関数名。

タスク制御ブロック (task control block (TCB)). DB2

に接続されたアドレス・スペース内のタスクに関する情報を通信する z/OS 制御ブロック。アドレス・スペース接続 (address space connection) も参照。

タスクの異常終了 (異常終了) (abnormal end of task

(abend)). 実行中にリカバリー機能によって解決できないエラー状態が発生したため、タスク、ジョブ、またはサブシステムを終了させること。

探索条件 (search condition). 表から行を選択する際の基準。 1 つの探索条件は、1 つまたは複数の述部から構成される。

単純表スペース (simple table space). 区分化されたりセグメント化されない表スペース。

単純ページ・セット (simple page set). 区分化されていないページ・セット。単純ページ・セットは最初に単純データ・セット (ページ・セット部分) からなる。データ・セットが 2 GB に拡張される場合は、別のデータ・セットが作成されて合計 32 までのデータ・セットとなる。 DB2 このデータ・セットを、最大 64 GB

が含まれる連続した線形アドレス・スペースであると見なす。データは、区分化している構造とは見なされず、このアドレス・スペース内で次に使用可能なロケーションに保管される。

単精度浮動小数点数 (single-precision floating point

number). 実数を 32 ビットで近似表現したもの。

端末モニター・プログラム (Terminal Monitor Program

(TMP)). 端末ユーザーとコマンド・プロセッサーとの間のインターフェースを提供するプログラムで、多数のシステム・サービスへのアクセスを所持している (z/OS

の場合)。

用語集 497

チェックポイント (checkpoint). DB2 が、 DB2 ログに内部状況情報を記録する点。リカバリー処理では、DB2 が異常終了した場合にこの情報を使用する。

チェック保全性 (check integrity). 表の中の各行がその表で定義された検査制約に準拠するときに存在する条件。チェック保全性を維持するには、データを追加または変更する操作に、 DB2 が検査制約を強制する必要がある。

チェック・ペンディング (check pending). 表スペースにまたは区画に、参照制約または検査制約、あるいはその両方に違反する行が含まれる可能性があるため、一部のユーティリティーおよび一部の SQL ステートメントによってその使用が止められた状態。

置換文字 (substitution character). ソース・プログラムの、宛先コーディング表示に一致する文字のない任意の文字を文字変換するときに、置換される固有の文字。

中央演算処理複合システム (central processor complex

(CPC)). (ES/3090™ のような) ハードウェアの物理的集合で、メインストレージ、1 つまたはそれ以上の中央処理装置、タイマー、およびチャネルで構成される。

中央処理装置 (central processor (CP)). 命令実行、初期プログラム・ロード、および他のマシン操作の順序付けおよび処理機能を含むコンピューターの一部。

中央電子複合システム (central electronic complex

(CEC)). 中央処理装置複合システム (central processor

complex) を参照。

中間データベース・サーバー (intermediate database

server). 別のデータベース・サーバーに転送される、ローカル・アプリケーションまたはリモート・アプリケーション・リクエスターからの要求のターゲット。 DB2

環境では、3 パート名で参照されるオブジェクトがローカル・ロケーションを参照しない場合、リモート要求は他のデータベース・サーバーに透過的に転送される。

調整プログラム (coordinator). 1 つまたは複数の他のシステム上で行われた作業を含む作業単位のコミットもしくはロールバックを調整する、システム・コンポーネント。

直接的な名前 (exposed name). 相関名、または相関名が指定されていない表またはビュー名。 FROM 文節に指定される名前には、公開および非公開のものがある。

通常 ID (ordinary identifier). 英大文字の後に 0 または複数の文字が続く。それぞれの文字は英大文字、数字、または下線文字である。通常 ID は予約語であってはならない。

通常トークン (ordinary token). 数値定数、通常 ID、ホスト ID、またはキーワード。

通信データベース (communications database (CDB)).

リモート・データベース管理システムとの会話を確立する際に使用される DB2 カタログの中の表集合。

強い型定義 (strong typing). 特殊タイプに定義されているユーザー定義関数および操作だけがそのタイプに適用できることを保証する処理。例えば、カナダ・ドルとU.S. ドルなどの 2 つの通貨タイプを直接比較することはできない。しかし、一方の通貨をもう一方の通貨に変換してから比較するユーザー定義関数を用意することはできる。

ツリー構造 (tree structure). ノード内のエンティティーを表すデータ構造。各ノードについては親ノードはほとんどの場合 1 つで、ルート・ノードは 1 つのみである。

データウェアハウス (data warehouse). 組織に重要なビジネス情報を提供するシステム。データウェアハウス・システムは、データが正確度と現行性を保つようデータの浄化を行ってから意思決定する人に提供し、そのデータを効果的かつ効率的に解釈して使用できるようにする。

データ共用 (data sharing). 2 つまたはそれ以上のDB2 サブシステムが、単一セットのデータに直接アクセスし、それを変更できる機能。

データ共用グループ (data sharing group). 1 つまたは複数の DB2 サブシステムの集合。データ保全性を保持しつつ、同じデータに直接アクセスし、それを変更する。

データ共用メンバー (data sharing member). XCF サービスによって、データ共用グループに割り当てられるDB2 サブシステム。

データ区分 (data partition). 区分表スペースに置かれている VSAM データ・セット。

データ区分副次索引 (data-partitioned secondary index

(DPSI)). パーティション化された副次索引。索引は、基本データに基づいてパーティション化される。

データ言語 (DL/I) (Data Language/I (DL/I)). IMS データ操作言語。ユーザー・アプリケーションと IMS との間の共通高水準インターフェース。

データ主導ビジネス・ルール (data-drivenbusiness

rules). ビジネスの要求の結果として存在する特定のデータ値の制約。


データ定義名 (DD 名) (data definition name

(ddname)). 同じ名前が入っているデータ制御ブロックに対応する、データ定義 (DD) ステートメントの名前。

データの現行性 (data currency). 検索されてプログラム内のホスト変数に入れられたデータが、基本表のデータのコピーである状態。

データベース (database). 表の集合、または表スペースおよび索引スペースの集合。

データベース ID (database identifier (DBID)). データベースの内部 ID。

データベース管理システム (database management

system (DBMS)). データベースの作成、編成、および変更、ならびにデータベース内に保管されたデータへのアクセスを制御するソフトウェア・システム。

データベース管理者 (database administrator (DBA)).

データベースの設計、開発、運用、保護、保守、および使用に対して責任を持つ個人。

データベース記述子 (DBD) (database descriptor

(DBD)). DB2 データベース定義の内部表現の 1 つであり、DB2 カタログ内にあるデータ定義を反映している。データベース記述子に定義されるオブジェクトには、表スペース、表、索引、索引スペース、関係、チェック制約、およびトリガーがある。DBD にはまた、データベース内の表へのアクセスに関する情報が含まれる。

データベース別名 (database alias). ロケーション名と異なる場合のターゲット・サーバー名。データベース別名は、ネットワークで既知のデータベース・サーバー名を提供する。データベース別名が定義された場合、ロケーション名はサーバーを参照するためにアプリケーションが使用するが、データベース別名はアクセスするデータベース・サーバーを識別するために使用される。SQL ステートメント内の完全修飾オブジェクト名は、すべて変更されずにデータベース・サーバーへ送信される。

データベース要求モジュール (database request module

(DBRM)). DB2 プリコンパイラーにより作成され、SQL ステートメントについての情報が入っているデータ・セット・メンバー。 DBRM は、バインド処理で使用される。

データベース例外状況 (database exception status). データベースに障害が生じているという指示。データ共用グループのすべてのメンバーは、データベースの例外状況について知り、それを共用している必要がある。

データベース・アクセス・スレッド (database access

thread). リモート・サブシステムに代わってローカル・サブシステムでデータにアクセスするスレッド。

データベース・サーバー (database server). ローカル・アプリケーションまたは中間データベース・サーバーからの要求のターゲット。 DB2 環境においては、データベース・サーバー機能は、ローカル・アプリケーションから、もしくは中間データベース・サーバーとして動作するリモート・データベースから DB2 データにアクセスするために、分散データ機能によって提供される。

データマート (data mart). 単一の部門またはチームに適用される小さなデータウェアハウス。データウェアハウス (data warehouse) も参照。

データ・スペース (data space). DB2 UDB for z/OS

V8 より前のリリースでは、プログラムが直接操作できる、最大 2GB の連続した仮想記憶域アドレス。アドレス・スペースとは異なり、データ・スペースに保持できるのはデータだけであり、共通域、システム・データ、またはプログラムは含まない。

データ・ソース (data source). ローカルまたはリモートのリレーショナルまたは非リレーショナルのデータ・マネージャーであり、ODBC API をサポートするODBC ドライバーを介したデータ・アクセスをサポートする。 DB2 UDB for z/OS の場合、データ・ソースは、常にリレーショナル・データベース・マネージャーにある。

データ・タイプ (data type). 列、リテラル、ホスト変数、特殊レジスター、および関数と式の結果の属性。

データ・ディクショナリー (datadictionary). 組織のアプリケーション・プログラム、データベース、論理データ・モデル、ユーザー、および許可に関する情報のリポジトリー。データ・ディクショナリーには、手動と自動がある。

データ・マイニング (data mining). データウェアハウスから重要なビジネス情報を収集し、それの相関を取って、関連、パターン、および傾向を明らかにするための処理。

定数 (constant). 変更されない値を指定する言語エレメント。定数を分類すると、ストリング定数と数値定数がある。変数 (variable) と比較。

ディスク (disk). データを磁気的に記録する直接アクセス・ストレージ・デバイス。

ディメンション (dimension). 時間、製品、または市場などのデータ・カテゴリー。ディメンションのエレメン

用語集 499

||

||||||||||

||||||

||

トをメンバーという。ディメンションは、検索、探査、および分析のために、データの編成と選択を行うためのきわめて簡潔で直観的な方法を提供する。ディメンション表 (dimension table) も参照。

ディメンション表 (dimension table). スタースキーマ内のディメンションの表現。ディメンション表の各行は、ディメンションの各メンバーの全属性を表す。ディメンション (dimension)、スタースキーマ (star

schema)、およびスター型結合 (star join) も参照。

ディレクトリー (directory). データベース記述子およびスケルトン・カーソル表のような内部オブジェクトが入っている DB2 システム・データベース。

出口ルーチン (exit routine). DB2 から制御を受け、特定の機能を実行するユーザー作成 (もしくは IBM 提供のデフォルト) プログラム。出口ルーチンは DB2 の拡張として実行する。

デッドロック (deadlock). 表あるいは索引などのリソースを使用する場合の、解決不可能な競合。

デフォルト値 (default value). 他に明示的な指定がないときに想定される、事前に決定された値、属性またはオプション。

テンプレート (template). 動的割り振りに使用されるDB2 ユーティリティーの出力データ・セット記述子。テンプレートは、TEMPLATE ユーティリティー制御ステートメントによって定義される。

同義語 (synonym). SQL における表または視点の代替名。同義語が定義されているサブシステムにあるオブジェクトのみを参照する場合に、該当の同義語を使用する。

同期点 (sync point). コミット点 (commit point) を参照。

同期点ツリー (syncpoint tree). リカバリー・マネージャーから始まる作業論理単位に関係し、最終的なコミット判断を行う、リカバリー・マネージャーとリソース・マネージャーのツリー。

動的 SQL (dynamic SQL). プログラムの実行中にアプリケーション・プログラム内で準備され、実行されるSQL ステートメント。動的 SQL の場合、SQL ソースは、アプリケーション・プログラム内にコーディングされずに、ホスト言語変数に入れられる。 SQL ステートメントは、アプリケーション・プログラムの実行中に数回変更することができる。

動的カーソル (dynamic cursor). アプリケーション・プログラムがカーソルが開いた後結果表のサイズとその

結果表の行の順番を変更するために使用する、名前の付いた制御構造。静的カーソル (static cursor) と比較。

動的ステートメント・キャッシュ・プール (dynamic

statement cachepool). 2 GB ストレージ・ラインより上に位置する、動的ステートメントを保有するキャッシュ。

動的ダンプ (dynamic dump). プログラムの実行中に、通常はそのプログラムの制御下で出されるダンプ。

特殊タイプ (Distinct Type). ユーザー定義のデータ・タイプであり、内部的には既存のタイプ (そのソース・タイプ) として表されるが、意味 (セマンティック) 上の目的から、別個で互換性のないタイプであると見なされる。

特殊レジスター (special register). アプリケーション・プロセス用として DB2 が定義するストレージ域であり、SQL ステートメントで参照できる情報を保管するために使用される。特殊レジスターの例として、USER

および CURRENT DATE がある。

特定関数名 (specific function name). その特定の名前によってデータベース・マネージャーに認識される特定のユーザー定義関数。多数のユーザー定義関数が同じ関数名を持つことができる。ユーザー定義関数がデータベースに定義されると、それぞれの関数に、そのスキーマ内で固有な特定の名前が割り当てられる。ユーザーがこの名前を提供するか、またはデフォルト名を使用することができる。

独立 (independent). 親でもなく、別のオブジェクトに従属もしていないオブジェクト (行、表、または表スペース)。

独立型 (stand-alone). DB2 のサービスを使用せずに、DB2 から独立して実行できることを意味するプログラムの属性。

特権 (privilege). 特定の機能、ときには特定のオブジェクトに対する機能を実行する能力。特権のタイプは以下のとおり。明示的な特権 (explicit privileges)。名前を持ち、SQL

GRANT および REVOKE ステートメントの結果として保留される。例えば、SELECT 特権。暗黙特権 (implicit privileges)。所有している同義語をドロップする特権といったオブジェクトの所有権、またはユーティリティー・ジョブを終了するSYSADM 権限の特権といった権限の保持が付随している。

特権セット (privilege set). インストール SYSADM ID

の場合に可能なすべての特権のセット。その他の許可


||

||

||||

ID の場合では、 DB2 カタログ内の該当 ID について記録されているすべての特権のセット。

ドメイン (domain). 属性の有効な値の集合。

ドメイン・ネーム (domain name). TCP/IP ネットワーク内で TCP/IP ホストを参照するために TCP/IP アプリケーションが使用する名前。

ドメイン・ネーム・サーバー (domain name server

(DNS)). 特殊 TCP/IP ネットワーク・サーバー。TCP/IP

ホスト名を IP アドレスにマップする際に使用する分散ディレクトリーを管理する。

トランザクション・プログラム名 (transaction program

name). SNA LU 6.2 の会話では、会話の相手先となるリモート論理装置にあるプログラムの名前。

トランザクション・ロック (transaction lock). SQL ステートメントの並行実行を制御するために使用されるロック。

トリガー SQL ステートメント (triggered SQL

statements). トリガーが起動され、そのトリガー・アクションの条件が真であると評価されたときに実行されるSQL ステートメントの集合。トリガー SQL ステートメントは、トリガー本体 (trigger body) とも呼ばれる。

トリガー SQL 操作 (triggering SQL operation). 対象表で実行された時にトリガーがアクティブにされるSQL 操作。

トリガー (trigger). DB2 データベース内に保管されていて、 DB2 表内のあるイベントが発生すると実行される SQL ステートメント。

トリガー起動 (trigger activation). トリガー定義の中に定義されているトリガー・イベントが実行されたときに発生する処理。トリガー起動は、トリガー・アクション条件の評価と、トリガー SQL ステートメントの条件付き実行とで構成される。

トリガー起動時間 (trigger activation time). トリガー定義の中の指示であり、トリガー・イベントの前または後のどちらでトリガーをアクティブにするかを示す。

トリガー細分性 (trigger granularity). トリガーの特性であり、トリガーをアクティブにするかどうかを以下のように決定する。v トリガーとなる SQL ステートメントについて 1 回のみ

v SQL ステートメントが変更するそれぞれの行ごとに1 回

トリガー本体 (trigger body). トリガーが起動され、そのトリガー・アクションの条件が真であると評価されたときに実行される SQL ステートメントの集合。トリガー本体はトリガー SQL ステートメントとも呼ばれる。

トリガー・アクション (triggered action). トリガーがアクティブにされたときに実行される SQL 論理。トリガー・アクションは、オプションのトリガー・アクション条件と、その条件が真であると評価された場合にのみ実行されるトリガー SQL ステートメントの集合で構成される。

トリガー・アクション条件 (triggered action

condition). トリガー・アクションのオプション部分。このブール条件は、WHEN 文節で表し、トリガー SQL

ステートメントを実行すべきかどうかを判別するためにDB2 が評価する条件を指定する。

トリガー・イベント (triggering event). そのトリガーを起動させる、トリガー定義で指定された操作。トリガー・イベントは、トリガー操作 (INSERT、UPDATE、または DELETE) と、その操作が実行される対象表で構成される。

トリガー・カスケード (trigger cascading). トリガーのトリガー・アクションによって別のトリガーが起動されるときに行われるプロセス。

トリガー・パッケージ (trigger package). CREATE

TRIGGER ステートメントが実行されるときに作成されるパッケージ。パッケージは、トリガーが起動されると実行される。

取り消し (undo). リカバリー可能な DB2 リソースに対してリカバリー単位が行った変更をバックアウトする必要があることを示す、リカバリー単位の状態。

トレース (trace). DB2 のモニター、監査、パフォーマンス、アカウンティング、統計、および保守容易性 (グローバル) 関連のデータをモニターし、収集する能力を提供する DB2 機能。

ドレーン (drain). ロックされたリソースを、そのオブジェクトへのアクセスを静止することによって獲得する行為。

ドレーン・ロック (drain lock). クレームの発生を防ぐ、クレーム・クラスでのロック。

［ナ行］内部結合 (inner join). 結合された双方の表に一致する行のみを含む結合操作の結果。結合 (join) も参照。

用語集 501

内部リソース・ロック・マネージャー (internal

resource lock manager (IRLM)). DB2 が通信およびデータベース・ロッキングを制御するために使用するz/OS サブシステム。

日本工業規格 (Japanese Industrial Standard). 日本語の文字を処理するために使用されるコード化スキーム。

ヌル値 (null). 情報が存在しないことを示す特殊な値。

ヌル終止符 (null terminator). C では、ストリングの終了を示す値。 EBCDIC、ASCII、および Unicode

UTF-8 ストリングに対しては、ヌル終止符は単一バイト値 (X'00') である。Unicode UCS-2 (幅) ストリングに対しては、ヌル終止符は 2 バイト値 (X'0000') である。

ヌル終了ホスト変数 (null-terminated host variable).

データの終了をヌル終止符で示す可変長ホスト変数。

ネストされた表式 (nested table expression). FROM 文節内の全選択 (括弧で囲まれている)。

ネットワーク ID (network identifier (NID)). IMS または CICS によって割り当てられたネットワーク ID、または接続タイプが RRSAF の場合、RRS リカバリー単位 ID (URID)。

［ハ行］パーティション (partition). ページ・セットの一部分。各区画は、単一の、独立して拡張できるデータ・セットに対応する。区画のサイズは、区分化ページ・セットの区画の数に応じて、最大 1、2、もしくは 4 GB まで拡張できる。一定のページ・セットの区画は、すべて同じ最大サイズを持つ。

パーティション化表スペース (partitioned table space).

(索引キーの範囲に基づき) 部分に分割される表スペースであり、それぞれユーティリティーによって独立して処理できる。

パーティション索引 (partitioned index). 物理分割された索引。区分化索引、副次索引ともパーティション化できる。

パーティション・プルーニング (partition pruning). 照会を満たすため特定のパーティションにのみアクセスするよう、パーティション化された表上の照会に述部を設定することにより、考慮事項から適用できないパーティションを除去する。

パートナー論理装置 (partner logical unit). VTAM 会話によってローカル DB2 サブシステムに接続されたSNA ネットワーク内のアクセス・ポイント。

倍精度浮動小数点数 (double-precision floating point

number). 実数を 64 ビットで近似表現したもの。

排他ロック (exclusive lock). 並行して実行されているアプリケーションによるデータの読み取りまたは変更の処理を防ぐロック。共用ロック (share lock) と比較。

バイナリー・ストリング (binary string). CCSID に関連付けられていない一連のバイト列。例えば、BLOB

データ・タイプはバイナリー・ストリングである。

バインド (bind). SQL プリコンパイラーからの出力を、使用可能な制御構造 (アクセス・プラン、アプリケーション・プラン、またはパッケージと呼ばれることがある) に変換するための処理。この処理の間に、データへのアクセス・パスが選択され、ある種の許可検査が行われる。バインドのタイプは、以下のとおりである。自動バインド (automatic bind). (より正確に言えば、自動再バインド (automatic rebind))。アプリケーション・プロセスが実行を開始し、そのプロセスが必要とするバインド済みアプリケーション・プランまたはパッケージが有効でないとき、SQL ステートメントが自動的にバインドされる (ユーザーが BIND

コマンドを出さなくても実行される) 処理。ダイナミック・バインド (dynamic bind). SQL ステートメントはその入力と同時にバインドされる。追加バインド (incremental bind). SQL ステートメントは、アプリケーション・プロセスの実行中にバインドされる。静的バインド (static bind). SQL ステートメントは、それがプリコンパイルされた後でバインドされる。すべての静的 SQL ステートメントの実行準備は、同時に行われる。

パス (path). SQL パス (SQL path) を参照。

バックアウト (backout). アプリケーション・プロセスが行った、コミットされていない変更を取り消すための処理。これは、万一アプリケーション・プロセスの一部が失敗した場合、またはデッドロック状態の結果として、必要となる場合がある。

パッケージ (package). 静的にバインドされ、処理に使用できる 1 組の SQL ステートメントが入っているオブジェクト。パッケージは、アプリケーション・パッケージ (application package) とも呼ばれる。

パッケージ名 (package name). BIND PACKAGE または REBIND PACKAGE コマンドによって作成されるオブジェクトの名前。オブジェクトとは、データベース要求モジュール (DBRM) のバインドされたものを言う。パッケージ名は、ロケーション名、コレクション ID、パッケージ ID、およびバージョン ID から構成される。


||

|||

|||||

パッケージ・リスト (package list). アプリケーション計画を拡張する際に使用できるパッケージ名の順序付けられたリスト。

発信元チェック ("come from" checking). パートナーLU から DB2 への接続を認める許可 ID のリストを定義する、LU 6.2 セキュリティー・オプション。

バッチ・メッセージ処理プログラム (batch message

processing program). IMS において、オンラインでバッチ・タイプの処理を行え、IMS 入出力メッセージ・キューにアクセスできるアプリケーション・プログラム。

バッファー・プール (buffer pool). 1 つ以上の表スペースもしくは索引用のバッファー要件を満たすために予約された主ストレージ。

パネル (panel). 表示面での表示フィールドの位置および特性を定義する事前定義の表示イメージ (例えば、メニュー・パネル)。

パラメーター名 (parameter-name). SQL プロシージャーまたは SQL 関数内にパラメーターを指定する SQL

ID。

パラメーター・マーカー (parameter marker). 動的SQL ステートメントのステートメント・ストリングに表示される疑問符 (?)。ステートメント・ストリングが静的 SQL ステートメントであった場合、疑問符は、ホスト変数を置ける位置に置くことができる。

版 (version). 類似したプログラム、DBRM、パッケージ、または LOB の集合のメンバー。プログラムのバージョン (版) は、プログラムのプリコンパイルによって作成されたソース・コードである。プログラム版は、プログラム名およびタイム・スタンプ (整合性トークン) によって識別される。DBRM のバージョン(版) は、プログラムのプリコンパイルによって作成される DBRM である。 DBRM

版は、対応するプログラム版と同じプログラム名およびタイム・スタンプによって識別される。パッケージの版は、特定データベース・システム内の DBRM をバインディングした結果。パッケージ・バージョンは、DBRM と同じプログラム名および整合性トークンによって識別される。LOB の版は、ある時点での LOB 値のコピー。LOB の版番号は、LOB の補助索引項目内に保管される。

ハンドル (handle). DB2 ODBC では、データ構造および関連するリソースを参照する変数。ステートメント・ハンドル (statement handle)、接続ハンドル (connection

handle)、および環境ハンドル (environment handle) も参照。

反復可能読み取り (repeatable read (RR)). 他の実行アプリケーション・プログラムからの保護を最大にする分離レベル。アプリケーション・プログラムが反復可能読み取り保護を伴って実行される場合、プログラムが参照する行は、プログラムがコミット・ポイントに到達するまでは他のプログラムによって変更できない。

汎用トレース機能 (GTF) (generalized trace facility

(GTF)). 入出力割り込み、SVC 割り込み、プログラム割り込み、または外部割り込みなどの重要なシステム・イベントを記録する z/OS サービス・プログラム。

汎用リソース名 (generic resource name). VTAM が使用する名前であり、シスプレックス環境におけるセッション分散および平衡化を処理するために同じ機能を提供するいくつかのアプリケーション・プログラムを表す。

非 deterministic 関数 (nondeterministic function). 結果が、入力引数だけに依存しているのではないユーザー定義関数。つまり、次の呼び出しで、同じ引数値が異なる結果を作成する可能性がある関数。このタイプの関数は、可変 (variant) 関数と呼ばれることもある。同じ入力に対して常に同じ結果を生成する、deterministic 関数 (deterministic function) (非可変関数 (not-variant

function) とも呼ばれる) と比較。

ピース (piece). 区分化されていないページ・セットのデータ・セット。

比較演算子 (comparison operator). 2 つの値の間の関係を指定するために使用されるトークン (=、>、< など)。

非可変関数 (not-variant function). deterministic 関数(deterministic function) を参照。

非感知カーソル (insensitive cursor). 結果表がマテリアライズされた後、その結果表の基本行に対して行われた挿入、更新、または削除を感知しないカーソル。

非区分化索引 (nonpartitionedindex). 物理分割されていない索引。区分化索引、副次索引とも非区分化にできる。

非コミット読み取り (uncommitted read (UR)). アプリケーションが非コミット・データを読み取ることができる分離レベル。

ビジネス・ディメンション (business dimension). 1 つの組織で分析したい製品または時間枠などのデータ・カテゴリーの 1 つ。

非正規化 (denormalization). 物理リレーショナル・データベースの設計を行う作業における主要なステップの1 つ。非正規化は、意図的に列を複数の表に重複させ、

用語集 503

||||

|||

|||

結果としてデータ冗長度を増加させる。非正規化は時として、パフォーマンス上の問題を最小化するために必要である。正規化 (normalization) と比較。

左外部結合 (left outer join). 結合されている両方の表の一致した行が入っており、最初の表の不一致行を保存する結合操作の結果。結合 (join) も参照。

日付 (date). 日、月、および年を示す 3 つの部分から構成される値。

日付 / 時刻値 (datetime value). データ・タイプDATE、TIME、または TIMESTAMP の値。

日付期間 (date duration). 年、月、日の数を表す 10

進整数。

ビット・データ (bit data). 文字タイプが CHAR または VARCHAR で、CCSID 値が 65535 のデータ。

ビュー (view). 1 つまたは複数の表のデータの代替表現。ビューには、それが定義される表内に含まれる、すべてまたは一部の列を含めることができる。

ヒューリスティックな決定 (heuristic decision). 参加プログラムにおいて未確定の解決を強制的に実行する決定。調整プログラムと参加プログラムとの間で自動的に実施される再同期とは異なる。

ヒューリスティック・ダメージ (heuristic damage). 未確定の LUW を解決するための 1 つ以上の参加プログラムにおけるヒューリスティックな決定が、調整プログラムで記録された決定と異なるときに、参加プログラムの間で生じるデータの矛盾。

ビュー・チェック・オプション (view check option).

ビューを通して挿入または更新された行が、そのビューの定義に準拠する必要があるかを指定するオプション。ビュー・チェック・オプションは、CREATE VIEW ステートメントの WITH CASCADED CHECK

OPTION、WITH CHECK OPTION、または WITH

LOCAL CHECK OPTION 文節と一緒に指定することができる。

表 (table). 一定数の列と、順序および数が不定な行から構成される名前付きのデータ・オブジェクト。基本表 (base table) または一時表 (temporary table) も参照。

表関数 (table function). 引数の集合を受け取って、その関数を参照する SQL ステートメントに表を戻す関数。表関数は、副選択の FROM 文節の中でのみ参照できる。

標識変数 (indicator variable). アプリケーション・プログラムでヌル値を表すために使用される変数。選択された列の値がヌルであると、負の値が標識変数に入れられる。

標識列 (indicator column). LOB 列の代わりに基本表に保管される 4 バイトの値。

表スペース (table space). レコードを 1 つまたは複数の表に保管するために使用されるページ・セット。

表スペース・セット (table space set). 以下のうちの 1

つの理由により、一緒にリカバリーすべきである表スペースと区画のセット。v それぞれに、他のものの表の親または子孫である表が含まれている。

v セットに基本表が含まれ、補助表に関連している。

1 つの表スペースの集合に、両方のタイプの関係を含めることができる。

表制御区分化 (table-controlledpartitioning). パーティション化された表のパーティション境界が、CREATE

TABLE ステートメント上に定義された値によって制御される区分化のタイプ。パーティション境界は、SYSIBM.SYSTABLEPART カタログ表のLIMITKEY_INTERNAL 列上に保管される。

表ロケーター (table locator). SELECT ステートメントの FROM 文節、INSERT ステートメントの副選択、あるいはユーザー定義関数の中から、トリガー変換表へのアクセスを可能にする機構。表ロケーターは、変換表を表すフルワードの整数値。

非リーフ・ページ (nonleaf page). 索引中に他のページ(リーフ、または非リーフ・ページ) のキーおよび番号を含んでいるページ。非リーフ・ページは実データを指さない。

ブートストラップ・データ・セット (BSDS) (Bootstrap

data set (BSDS)). すべてのアクティブ・ログ・データ・セットおよびアーカイブ・ログ・データ・セットについて、RBA 範囲指定とともに DB2 の名前と状況情報が入っている VSAM データ・セット。さらに、DB2

ディレクトリーおよびカタログについてのパスワード、ならびに条件付き再始動およびチェックポイント・レコードのリストも含まれる。

ファイル入力式 SQL 処理プログラム (SQL Processor

Using File Input(SPUFI)). TSO 接続サブコンポーネントの機能。DB2I ユーザーは、これによって SQL ステートメントをアプリケーション・プログラムに組み込まずに実行することができる。


##

ファン・セット (fan set). 索引、ハッシュ、またはリンクによって提供されるデータへの直接物理アクセス・パス。ファン・セットは、データ・マネージャーがデータの配列をサポートする手段である。

フィールド手順 (field procedure). 単一の値を受け取り、それをユーザーが指定できる任意の方法で変形 (エンコードまたはデコード) するように設計された、ユーザー作成の出口ルーチン。

フィルター要因 (filter factor). 表内で述部が真の行の比率を見積もった、0 から 1 までの数値。

フェッチ・オリエンテーション (fetch orientation).

FETCH ステートメントの一部としてカーソルの望ましい配置を指定すること (例えば、BEFORE、 AFTER、NEXT、 PRIOR、 CURRENT、 FIRST、 LAST、ABSOLUTE、および RELATIVE)。

フェデレーテッド・データベース (federated database).

DB2 Universal Database サーバー (Linux、UNIX®、および Windows® 環境における) とサーバーが照会を送る複数のデータ・ソースとの組み合わせ。連合データベース・システムでは、クライアント・アプリケーションは、単一の SQL ステートメントを使用して複数のデータベース管理システムに分散されているデータを結合することができ、そのデータをあたかもローカルに存在しているかのように表示させることができる。

フォールバック (fallback). 現行リリースへのマイグレーションを試みた後、または完了した後、直前の DB2

のリリースに戻る処理。

複合キー (composite key). 同じ表のキー列が一定順序に並んだものの集合。

副次索引 (secondary index). パーティション化された表上の非パーティション索引。

副照会 (subquery). 別の SQL ステートメントのWHERE 文節または HAVING 文節の内側に置かれたSELECT ステートメント。ネストされた SQL ステートメント。

副選択 (subselect). ORDER BY 文節、UPDATE 文節、または UNION 演算子を含まない照会形式。

物理クレーム (physical claim). 非区分化索引全体のクレーム。

物理的コンプリート (physically complete). 並行コピー処理が完了し、出力データ・セットが作成されている状態。

物理的な一貫性 (physical consistency). 部分変更状態でないページの状態。

物理ドレーン (physical drain). 非区分化索引全体のドレーン。

物理ロック (P ロック) (physical lock (P-lock)). 異なる DB2 サブシステムでキャッシュに入れられたデータの整合性を提供するために、DB2 サブシステムが獲得するロック・タイプの 1 つ。物理ロックは、データ共用環境でのみ使用される。論理ロック (L ロック)(logical

lock (L-lock)) と比較。

物理ロック競合 (physical lock contention). 物理ロックのリクエスターが対立している状態。交渉可能ロック(negotiable lock) も参照。

不変文字セット (invariant character set). (1) 構文文字セットなどの、コード・ポイント割り当てがコード・ページによって変更されない文字セット。 (2) 全文字セットの一部として使用可能な最小の文字セット。

プライベート・プロトコル接続 (private protocol

connection). アプリケーション処理の DB2 私用接続。私用接続 (private connection) も参照。

プライベート・プロトコル・アクセス (private protocol

access). 分散データにアクセスする方式の 1 つであり、この方式により、ユーザーは、照会を別の DB2 システムに直接送ることができる。アプリケーション指示アクセス (DRDA access) と比較。

プラン・メンバー (plan member). メンバー文節で識別される DBRM のバインドされたコピー。

フリー・スペース (free space). ページ内の合計未使用スペースの量。つまり、レコードまたは制御情報の格納のために使用されていないスペースがフリー・スペースである。

プリコンパイル (precompilation). SQL ステートメントが入っているアプリケーション・プログラムの処理で、コンパイル前に発生する。 SQL ステートメントは、ホスト言語コンパイラーによって認識されるステートメントにより置き換えられる。このプリコンパイルからの出力としては、コンパイラーに実行依頼できるソース・コード、およびバインド処理に入力されるデータベース要求モジュール (DBRM) などがある。

プリンシパル名 (principal name). DCE セキュリティー・サービスが認識しているプリンシパルの名前。

プログラム (program). プログラミング言語内実行可能ステートメントのコンパイル可能な単一の集合。

用語集 505

||

プログラム一時修正 (program temporary fix (PTF)).

ライセンス・プログラムの現在の更新されていないリリースにおいて、障害の結果と診断される問題の解決またはバイパス。プログラム診断依頼書 (APAR) の修正は、既存の問題の訂正サービスである。 PTF はその製品の他のユーザーに生じる可能性のある問題の予防サービス。通常、その製品には次のリリースまで永続的な修正は行われないので、PTF は一時的なものである。

プログラム診断依頼書 (authorized program analysis

report(APAR)). IBM が提供するプログラムの現行リリースにおける疑わしい障害が原因となって、引き起こされる問題のレポート。

プロセス (process). DB2 では、 DB2 がリソースおよびロックを割り当てる単位。アプリケーション・プロセス (application process) とも呼ばれ、処理には、1 つ以上のプログラムの実行が含まれる。 SQL ステートメントの実行は、常に何かの処理に関係する。処理の開始および終了の方法は、環境によって異なる。

ブロック・フェッチ (block fetch). DB2 が大量の行のセットをリトリーブまたはフェッチすることができる機能。ブロック・フェッチを使用すれば、ネットワークを介して送信されるメッセージの量を大幅に削減することができる。ブロック・フェッチは、データを更新しないカーソルにのみ適用される。

分散データ (distributed data). ローカル・システム以外の DBMS にあるデータ。

分散データ機能 (DDF) (distributed data facility

(DDF)). DB2 が他のリレーショナル・データベース管理システムと通信を行うのに使用する一組の DB2 コンポーネント。

分散リレーショナル・データベース体系 (Distributed

RelationalDatabase Architecture™ (DRDA)). IBM のリレーショナル・データベース・プロダクトにより使用される、分散リレーショナル・データベース処理用の接続プロトコル。 DRDA には、アプリケーションとリモートのリレーショナル・データベース管理システム間、およびリレーショナル・データベース管理システム間の通信用のプロトコルが組み込まれている。DRDA アクセスも参照。

文節 (clause). SQL において、SELECT 文節やWHERE 文節などのように、ステートメントの明確な一部分。

分離レベル (isolation level). 作業単位を他の作業単位の更新操作から分離する度合い。カーソル固定 (cursor

stability)、読み取り固定 (read stability)、反復可能読み取

り (repeatable read)、および非コミット読み取り(uncommitted read) も参照。

ページ (page). 表スペース (4KB、8KB、16KB、または 32KB)、あるいは索引スペース (4KB) 内のストレージの単位。表スペース内の 1 ページには、表の行が 1

つまたは複数入る。 LOB 表スペースでは、1 つのLOB 値を複数のページにスパンできるが、1 ページに保管される LOB 値は 1 つだけである。

ページ読み取り (getpage). DB2 によるデータ・ページへのアクセスが行われる操作。

ページ・セット (page set). 表スペースまたは索引スペースを表す別の方法。各ページ・セットは、VSAM データ・セットの集合から構成される。

ページ・セット・リカバリー・ペンディング (page set

recovery pending (PSRCP)). 索引スペースの制限的状態。この場合、ページ・セット全体をリカバリーする必要がある。論理部分のリカバリーは禁止されています。

並行性 (concurrency). 複数のアプリケーション処理による、リソースの同時共用使用。

米国規格協会 (American National Standards Institute

(ANSI)). 生産者側、消費者側、および一般の人のグループによって構成される組織。この組織が制定するプロシージャーによって、認可された団体が米国における任意の業界標準を作り維持する。

並列グループ (parallel group). 並列に実行され、同じ数の並列タスクを持つ 1 組の連続操作。

並列処理アシスタント (parallelism assistant). シスプレックス照会並列処理では、データ共用グループ内の別の DB2 サブシステムで開始された並列照会の一部の処理を支援する DB2 サブシステム。

並列処理調整プログラム (parallelism coordinator). シスプレックス照会並列処理では、並列照会が開始されたDB2 サブシステム。

並列処理の度合い (degree of parallelism). 並行して実行される、照会処理のために開始された操作の数。

並列タスク (parallel task). 並列で照会を処理するためにダイナミックに作成された実行単位。並列タスクはz/OS サービス要求ブロックによりインプリメントされる。

並列入出力処理 (parallel I/O processing). DB2 が単一ユーザーの照会に対して複数の並行要求を開始し、複数のデータ区画で並行して (並列で) 入出力処理を行う、入出力処理の 1 つの形式。


並列複合 (parallel complex). 複数のトランザクションおよびアプリケーションを処理するために一緒に作動するマシンのクラスター。

別名 (alias). 同一またはリモート DB2 サブシステムの中の表または視点を参照するために SQL ステートメントで使用できる代替名。

ヘルプ・パネル (help panel). チュートリアル・テキストを表示して、ワークステーションまたは端末上のユーザーを支援する情報画面。

変換表 (transition table). トリガー・イベントの発生前または発生後の状態において、影響を受けたすべての対象表の行を含む一時表。トリガー定義内のトリガー済み SQL ステートメントは、変更された行の表を、変更前の状態または変更後の状態で参照することができる。

変換変数 (transition variable). トリガー・イベントの発生前または発生後の状態において、影響を受けた対象表の行の列値を含む変数。トリガー定義内のトリガー済み SQL ステートメントは、変更前の値のセット、または変更後の値のセットを参照することができる。

変更ロック (modify locks). MODIFY 属性を持つ L ロックまたは P ロック。これらのアクティブ・ロックのリストは、常にカップリング・ファシリティーロック構造に保持されている。要求している DB2 に障害が起こると、その DB2 サブシステムの修正ロックは、保存ロックに変換される。

変数 (variable). 変更可能な値を指定するデータ・エレメント。 COBOL 基本データ項目は変数の一つ。定数(constant) と比較。

ポータブル・オペレーティング・システム・インターフェース (Portable Operating System Interface(POSIX)).

IEEE オペレーティング・システム・インターフェース規格であり、スレッド化の規格である Pthread を定義している。 Pthread も参照。

ホーム・アドレス・スペース (home address space).

現行で z/OS がディスパッチされたとして認識するストレージ。

ホール (hole). 行に対して行われた削除または更新のために、アクセスすることができない結果表の行。削除ホール (delete hole) および更新ホール (update hole) も参照。

保管プロシージャー (stored procedure). SQL CALL

ステートメントを使用して呼び出すことができる、ユーザー作成アプリケーション・プログラム。

保護会話 (protected conversation). 2 フェーズ・コミットの流れをサポートする VTAM 会話。

補助索引 (auxiliary index). 補助表の索引の 1 つであり、各索引項目が LOB を参照している。

補助表 (auxiliary table). 列が定義されている表の外部にその列を保管する表。基本表 (base table) と比較。

保持ロック (retained lock). サブシステムの障害の際にDB2 サブシステムが保持していた MODIFY ロック。ロックは DB2 の障害の間、カップリング・ファシリティーロック構造に保存される。

ホスト (host). 与えられた TCP/IP インスタンスで使用できるプログラムおよびリソースの集合。

ホスト ID (host identifier). ホスト・プログラム内で宣言される名前。

ホスト言語 (host language). SQL ステートメントを組み込めるプログラミング言語。

ホスト構造 (host structure). アプリケーション・プログラムにおいて、組み込み SQL ステートメントによって参照される構造。

ホスト式 (host expression). SQLJ アプリケーション・プログラム内の SQL 文節によって参照される Java 変数または式。

ホスト変数 (host variable). アプリケーション・プログラムにおいて、組み込み SQL ステートメントによって参照されるアプリケーション変数。

ホスト変数配列 (host variable array). 各々が列の値に対応するエレメントの配列。配列のディメンションは、配列が使用できる行の最大数を決定する。

ホスト・プログラム (host program). ホスト言語で書かれ、組み込み SQL ステートメントが含まれているアプリケーション・プログラム。

ポリシー (policy). CFRM ポリシー (CFRM policy) を参照。

［マ行］マイグレーション (migration). 以前のリリースの DB2

サブシステムを更新または現行リリースに変換する処理。この処理で、前リリースで作成したデータを失うことなく、更新または現行リリースの機能を獲得することができる。

マスター端末 (master terminal). オンライン操作中のIMS リソースへの完全な制御を持つ、 IMS 論理端末。

用語集 507

|||

マスター端末オペレーター (master terminal operator

(MTO)). マスター端末 (master terminal) を参照。

マッピング表 (mapping table). オリジナルおよびシャドー・コピー内のデータ・レコードの RID に関連するものをマップするために、REORG ユーティリティーが使用する表。この表はユーザーによって作成される。

マテリアライズ (materialize). (1) 視点またはネストされた表の式からの行を、照会による追加の処理のために作業ファイルに入れる処理。

(2) LOB 値を連続ストレージに入れること。 LOB 値はきわめて大きい可能性があるため、 DB2 絶対的に必要となるまで LOB データの具体化を回避する。

マテリアライズ照会表 (materialized query table). 1

つ以上のソース表から得られ、要約できる情報を組み込むために使用する表。

マルチサイト更新 (multisite update). 単一作業単位内の 1 つまたは複数のロケーションでデータの更新が行われる、分散リレーショナル・データベース処理。

マルチスレッド化 (multithreading). DB2 ODBC コードの 1 つのコピーを同時に (プロセッサーを共用して)

または並列に (別個の中央処理装置で) 実行する複数のTCB。

マルチバイト文字セット (multibyte character set

(MBCS)). 単一文字を複数のバイトで表す文字セット。1 バイト文字セット (single-byte character set) および 2

バイト文字セット (double-byte character set) と比較。ユニコード (Unicode) も参照。

未確定 (indoubt). リカバリー単位の状況。 DB2 がそのフェーズ 1 のコミット処理を終了した後、フェーズ2 を開始する前に障害を起こすと、個別のリカバリー単位をコミットすべきかロールバックすべきかが分かるのは、コミット調整プログラムのみである。緊急再始動時に、DB2 にその決定に必要な情報が不足している場合、DB2 が調整プログラムからその情報を得るまで、そのリカバリー単位は未確定 (indoubt) である。再始動時に、複数のリカバリー単位が未確定になる可能性がある。

未確定カーソル (ambiguous cursor). PREPARE またはEXECUTE IMMEDIATE SQL ステートメントを含むプランまたはパッケージにあるデータベース・カーソル。以下のステートメントが true となる。カーソルは FOR

READ ONLY 文節または FOR UPDATE OF 文節では定義されない。カーソルは、読み取り専用結果表上では定義されない。カーソルは SQL UPDATE またはDELETE ステートメント上で WHERE CURRENT 文節のターゲットにはならない。

未確定の解決 (indoubt resolution). 未確定な論理作業単位の状況を、コミット状態もしくはロールバック状態に変える処理。

未完了 (inflight). リカバリー単位の状況。 DB2 が、そのリカバリー単位がコミット処理のフェーズ 1 を完了する前に障害を起こした場合、 DB 2 は再始動時にそのリカバリー単位の更新を単にバックアウトするだけである。これらのリカバリー単位は、未完了 (inflight)

と呼ばれる。

右外部結合 (right outer join). 結合操作の結果であり、結合されている両方の表の一致した行が入っており、2 番目の結合オペランドの不一致行を保存している。結合 (join) も参照。

無効パッケージ (invalid package). ドロップされたオブジェクト (ユーザー定義関数以外) に依存するパッケージ。そのようなパッケージは、呼び出しの際に暗黙的に再バインドされる。作動不能パッケージ (inoperative

package) と比較。

明示的階層ロッキング (explicit hierarchical locking).

IRLM に認識されるリソース間の親子関係を設定するために使用されるロック。この種のロックでは、リソースに DB2 間インタレストが存在しないときに、グローバル・ロックのオーバーヘッドが回避される。

メタ言語 (metalanguage). 他の特殊言語を作成するために使用する言語。

メニュー (menu). オペレーターが選択できる機能の表示リスト。メニューは、メニュー・パネルとも呼ばれる。

メンバー名 (member name). データ共用グループ中の特定の DB2 サブシステムの z/OS XCF ID。

モード名 (mode name). 物理特性と論理特性の集合、およびセッションの属性に対する VTAM 名。

文字ストリング (character string). ビット・データ、1

バイト文字、または 1 バイト文字とマルチバイト文字の混合を表す一連のバイト。

文字セット (character set). 定義された文字の集合。

文字データ表示体系 (Character Data Representation

Architecture(CDRA)). ストリング・データの一貫性のある表現、処理、および交換を行うために使用されるアーキテクチャーの 1 つ。

文字変換 (character conversion). あるエンコード・スキームから別のエンコード・スキームに文字を変換する処理。


|||

文字ラージ・オブジェクト (CLOB) (character large

object). 1 バイト文字、または 1 バイト文字と 2 バイト文字の混合を表す一連のバイトからなり、その値のサイズは最大で 2 GB-1 までが可能である。一般的に、文字ラージ・オブジェクトは、文字ストリングがVARCHAR タイプの限度を超える可能性がある場合に使用される。

モデリング・データベース (modeling database). ワークステーションで作成する DB2 データベースの 1 つであり、 DB2 UDB for z/OS サブシステムをモデル化するために使用される。Index Advisor による評価が可能になる。

［ヤ行］ユーザー定義関数 (UDF). CREATE FUNCTION ステートメントを使用して DB2 に定義され、 SQL ステートメントで参照できる関数。ユーザー定義関数には、外部関数 (external function)、ソース関数 (sourced

function)、または SQL 関数 (SQL function) がある。組み込み関数 (built-in function) と比較。

ユーザー定義データ・タイプ (UDT) (user-defined data

type). 特殊タイプ (Distinct Type) (distinct type) を参照。

ユーザー・ビュー (user view). 論理データ・モデルで、ビジネスで必要とする重要情報のモデルまたは表現。

ユニーク索引 (unique index). 表内の列または列セットに同一のキー値が保管されないようにする索引。

ユニーク制約 (unique constraint). 1 次キーもしくはユニーク索引のキー内の 2 つの値が同一になり得ないSQL 規則。

ユニコード (Unicode). ISO-10646 規格に類似した規格。ユニコード規格のインプリメンテーションはいくつか存在する。このすべてが世界各地で使用されている数多くのスクリプトに含まれる文字の大部分を表記できる。

ユニバーサル固有 ID (Universal Unique Identifier

(UUID)). 時間的にも空間的にも不変で固有な ID (z/OS

の場合)。

要求コミット (request commit). 参加プログラムがデータを変更し、コミットまたはロールバックの準備が整った場合に準備フェーズに実行依頼される提案。

呼び出し接続機能 (call attachment facility (CAF)).

TSO または z/OS バッチで実行されるアプリケーション・プログラムのための DB2 接続機能。CAF は DSN

コマンド処理プログラムに代わるものであり、実行環境のより大きな制御を提供する。

読み取り固定 (read stability (RS)). 反復可能読み取りと類似した分離レベルだが、あるアプリケーション処理をその他すべての並行して実行されているアプリケーション処理から完全に分離するものではない。 RS レベルにおいては、同じ照会を 2 回以上出すアプリケーションは、現在実行中のアプリケーション・プロセスによって挿入されコミットされた行をさらに読み取る場合がある。

［ラ行］ラージ・オブジェクト (large object (LOB)). ビット・データ、1 バイト文字、2 バイト文字、または 1 バイト文字と 2 バイト文字の混合を表す一連のバイト。LOB の長さは、2GB -1 バイトまで可能。 BLOB 、CLOB 、および DBCLOB も参照。

ラッチ (latch). 並行イベントまたはシステム・リソースの使用を制御するための DB2 内部構造。

ラベル付き期間 (labeled duration). 年、月、日、時、分、秒、またはマイクロ秒の時間間隔を表す数値。

リーフ・ページ (leaf page). キーと RID の対を含み、実際のデータを指すページ。非リーフ・ページ (nonleaf

page) と比較。

リカバリー (recovery). システム障害の後で、データベースを再構築する処理。

リカバリー可能リソース・マネージャー・サービス接続機能 (Recoverable Resource Manager

Servicesattachment facility (RRSAF)). DB2 サブコンポーネントの 1 つ。 DB2 と z/OS システムでは RRS も使用する他のすべてのリソース・マネージャーとの間のリソース・コミットメントを調整するために、リソース・リカバリー・サービスを使用する。

リカバリー単位 ID (unit of recovery identifier

(URID)). リカバリー単位の先頭ログ・レコードのLOGRBA。 URID は、そのリカバリー単位の後続するすべてのログ・レコードにも現れる。

リカバリー単位 (unit of recovery). DB2 インスタンスなどの単一リソース管理プログラム内における、操作のリカバリー可能シーケンス。作業単位 (unit of work) と比較。

用語集 509

リカバリー・トークン (recovery token). リカバリーに使用されるエレメントの ID (例えば、NID またはURID)。

リカバリー・ペンディング (recovery pending

(RECP)). リカバリーする必要のある表スペースへのSQL アクセスを妨げる状態。

リカバリー・マネージャー (recovery manager). (1) コミット、アボート、チェックポイント、および再始動処理の間に、DB2 リソース管理プログラムの対話を制御する調整サービスを提供するサブコンポーネント。リカバリー・マネージャーは整合点に達したデータを保護するための他のサブシステム (例えば、IMS) の処理において参加プログラムとして機能することにより、他のサブシステムのリカバリー・メカニズムをサポートする。 (2) 2 フェーズ・コミットの実行において、作業論理単位の状態を保持し、即時アップストリーム調整プログラムおよびダウンストリーム参加プログラムに名前を指定するリカバリー・ログにアクセスできる調整プログラムまたは参加プログラム (あるいはその両方)。

リカバリー・ログ (recovery log). DB2 実行中に発生するイベントを記述し、その順序を示すレコードの集合。記録された情報は、DB2 の実行中に障害が起きた場合のリカバリーとして使用される。

リクエスター (requester). リモート・サーバーにあるデータにアクセスする要求のソース。 DB2 環境においては、リクエスター機能は分散データ機能によって提供される。

リスト (list). DB2 ユーティリティーが処理できるオブジェクトの 1 つのタイプであり、複数の表スペースまたは複数の索引スペース、あるいはその両方を識別する。リストは、LISTDEF ユーティリティー制御ステートメントを使用して定義される。

リスト構造 (list structure). データをキューのエレメントとして共用および操作することができるカップリング・ファシリティー構造。

リソース (resource). ロックまたはクレームのオブジェクトで、これは表スペース、索引スペース、データ区画、索引区分、または論理区画となる。

リソース管理表 (resource control table (RCT)). サイト提供のマクロ・パラメーターによって作成されるCICS 接続機能の構成。トランザクションもしくはトランザクション・グループの許可およびアクセス属性を定義する。

リソース限定機能 (resource limit facility (RLF)). ダイナミック操作 SQL ステートメントが指定の時間制限を

超えないようにする DB2 コードの一部。リソース限定機能は、管理プログラムとも呼ばれる。

リソース限定表 (resource limit specification

table(RLST)). リソース限定機能によって実行される制限を指定する、地域別定義の表。

リソース割り振り (resource allocation). 特にデータベース・リソースを扱う計画割り振りの一部。

リソース・マネージャー (resource manager). (1) 特定のリソースを管理する責任を持ち、作業論理単位内のリカバリー可能リソースに対して行われたすべての更新の整合性を保証する機能。管理されるリソースは、物理(例えば、ディスクまたは主ストレージ) または論理 (例えば、特定のタイプのシステム・サービス) となる。(2) 2 フェーズ・コミットの実行においては、変更されている可能性があるリカバリー可能リソースを持つ参加プログラム。リソース管理プログラムはリカバリー・ログへアクセスし、リカバリー可能リソースに対する作業論理単位の影響をコミットまたはロールバックできる。

リピーティング・グループ (repeating group). 1 つのエンティティーが、本質的に同一である複数の属性を含んでいる状態。繰り返しグループの存在は、第 1 正規形の要件に反する。第 1 正規形の要件を満たすエンティティーにおいては、それぞれの属性は、その意味およびその名前において、独立しており、固有である。正規化 (normalization) も参照。

リモート (remote). リモート DB2 サブシステム (つまり、ローカル以外の DB2 サブシステム) によって維持管理されるすべてのオブジェクト。例えば、リモート視点は、リモート DB2 サブシステムによって維持管理される視点。ローカル (local) と比較。

リモート接続要求 (remote attach request). リモート・ロケーションによってローカル DB2 サブシステムに接続する要求。具体的にいうと、送信される要求は SNA

機能管理ヘッダー 5 である。

リモート・サブシステム (remote subsystem). ローカル・サブシステム以外の RDBMS。ユーザーまたはアプリケーションはこれと通信することができる。このサブシステムは、物理的な意味でリモートである必要はなく、同一 z/OS システム下の同じプロセッサーで稼働するものでもよい。

リレーショナル・データベース (relational database

(RDB)). 表の集合と見なすことができるデータベースであって、リレーショナル・データ・モデルにしたがって操作できるもの。


リレーショナル・データベース管理システム (relational

database management system (RDBMS)). リレーショナル・データベースへのアクセスの編成および提供を行うハードウェアとソフトウェアの集合。

リレーショナル・データベース名 (RDBNAM)

(relational database name (RDBNAM)). ネットワークにおける RDBMS の固有の ID。 DB2 では、CDB 内の表 SYSIBM.LOCATIONS の LOCATION 列にある値にする必要がある。DB2 の資料では、LOCATION 値またはロケーション名として他の RDBMS の名前を参照する。

リレーション (relationship). 表の行もしくは 2 つの表の行の間の定義済み接続。リレーションは、参照制約の内部表示である。

リンク・エディット (link-edit). リンケージ・エディターを用いてロード可能なコンピューター・プログラムを作成するアクション。

リンク・パック域作成 (create link pack area

(CLPA)). リンク・パック・ページング可能域を初期化するための IPL 時に使用されるオプション。

リンケージ・エディター (linkage editor). 1 つ以上のオブジェクト・モジュールまたはロード・モジュールから、それらのモジュール間の相互参照を解決し、必要ならアドレスを調整することにより、ロード・モジュールを作成するためのコンピューター・プログラム。

ルーチン (routine). ユーザー定義関数またはストアード・プロシージャーのいずれかを意味する用語。

ルート・ページ (root page). 索引において最上位 (または先頭位置) にある索引ページ。

例外表 (exception table). CHECK DATA ユーティリティーが検出した、参照制約または検査制約に違反する行を保持している表。

レコード ID (record identifier : RID). 表に保管されているデータの行を識別するために DB2 が内部で使用する固有 ID。行 ID (row ID) と比較。

レコード ID (RID) プール (record identifier (RID)

pool). リスト・プリフェッチ処理中にレコード ID をソートするために使用する主記憶域。

レコード (record). 行もしくは他のデータのストレージでの表示。

レコード長 (record length). 表の中のすべての列の長さの合計であり、物理的にデータベースに格納されるデータの長さ。レコードは、列の定義によって、固定長と

可変長がある。すべての列が固定長であれば、レコードは固定長レコードになる。 1 つ以上の列が可変長列であれば、レコードは可変長になる。

レジストリー (registry). レジストリー・データベース(registry database) を参照。

レジストリー・データベース (registry database). プリンシパル、グループ、編成、アカウント、およびセキュリティー・ポリシーに関するセキュリティー情報のデータベース。

列 (column). 表の垂直方向のコンポーネント。列は名前と特定のデータ・タイプ (文字、10 進数、整数など)

を持つ。

列関数 (column function). 集約関数 (aggregate

function) を参照。

列挙リスト (enumerated list). LISTDEF ユーティリティー制御ステートメントを使用して定義される 1 組のDB2 オブジェクトであり、その中でパターン・マッチング文字 (*、%、_ または ?) は使用されない。

連結削除 (delete-connected). 表 P の従属か、または表P カスケードからの削除操作の対象である表の従属である表。

ローカル (local). ローカル DB2 サブシステムが維持管理するあらゆるオブジェクトを参照する 1 つの方法。例えば、ローカル表は、ローカル DB2 サブシステムによって維持管理される表である。リモート (remote) と比較。

ローカル・サブシステム (local subsystem). ユーザーまたはアプリケーション・プログラムが直接接続する(DB2 の場合は、 DB2 接続機能の 1 つにより接続される) 固有のリレーショナル DBMS。

ローカル・ロック (local lock). DB2 内の並行性制御を提供するが、DB2 間の並行性制御は提供しないロック。すなわち、その有効範囲は単一の DB2 である。

ロード・モジュール (load module). 主ストレージにロードして実行する場合に適したプログラム単位。リンケージ・エディターの出力。

ロード・リスト・エレメント (load list element). エントリー・ポイント名に基づいた特定のロード・モジュールのロードおよび削除を制御する z/OS 制御ブロック。

ロールバック (rollback). SQL ステートメントによって変更されたデータを、その最後のコミット点での状態に復元する処理。ロックはすべて解放される。コミット (commit) と比較。

用語集 511

##

|||

ログ (log). DB2 実行中に発生するイベントを記述し、そのイベントの順序を示すレコードの集合。こうして記録された情報は、DB2 実行中に障害が起きた場合のリカバリーに使用される。

ログ切り捨て (log truncation). RBA の明示的な開始を確立する処理。この RBA は、ログ・データの次のバイトが書き込まれる点である。

ログ初期設定 (log initialization). DB2 がログの現行終了の探索を試みる、再始動処理の第 1 フェーズ。

ログ・コントロール・インターバル定義 (log control

interval definition). セグメントがいかに記録されたかがわかる物理ロギングの接尾部は、物理的コントロール・インターバルに置かれる。

ログ・レコード・シーケンス番号 (log record sequence

number (LRSN)). データ共用メンバーと関連するログ・レコードの固有 ID。DB2 は、データ共用環境でリカバリーする場合 LRSN を使用する。

ログ・レコード・ヘッダー (log record header (LRH)).

制御情報を含む各論理レコード内の接頭部。

ロケーション (location). データベース・サーバーの固有の名前。アプリケーションは、ロケーション名を使用して DB2 データベース・サーバーにアクセスする。リモート・サーバーへのアクセス時に、ロケーション名をオーバーライドするために使用するデータベース別名。

ロケーション別名 (location alias). データベース・サーバーがネットワーク内で自身を定義するために使用する別名。アプリケーションは、この名前を使用して DB2

データベース・サーバーにアクセスできる。

ロケール (locale). 特定の言語と国のために定義されている CCSID と文字を結合した、ユーザー環境のサブセットの定義。

ロッキング (locking). データの保全性を保つための処理。ロッキングを行うと、並行ユーザーが不一致データをアクセスすることが禁止される。

ロック (lock). 並行イベントもしくはデータへのアクセスを制御する手段。 DB2 ロッキングは IRLM によって行われる。

ロック構造 (lock structure). 一連のロック項目からなるカップリング・ファシリティーデータ構造の 1 つであり、論理リソースの共用ロックおよび排他ロックをサポートする。

ロック時間 (lock duration). DB2 ロックを保留するインターバル。

ロック調整、ロックの格上げ (lock promotion). DB2

ロックのサイズまたはモードのレベルをより高位で限定的に変更する処理。

ロック・エスカレーション (lock escalation). 特定のリソースで同時に保持されているページ・ロックの数が事前に設定されている限界を超えたために、行ロック、ページ・ロック、または LOB ロックから表スペース・ロックにロックを格上げすること。

ロック・オブジェクト (lock object). DB2 ロックによって制御されるリソース。

ロック・サイズ (lock size). 表データ上の DB2 ロックによって制御されるデータの量。値には行、ページ、LOB、区画、表、または表スペースが可能。

ロック・モード (lock mode). DB2 ロックが保留されているリソースに対して、並行して実行しているプログラムが持つことができるアクセスのタイプに関する表現。

論理区画 (logical partition). 非区分化索引の中の、特定の区画に関連付けられたキーまたは RID ペアの集合。

論理クレーム (logical claim). 非区分化索引の論理区画のクレーム。

論理索引区分 (logical index partition). 同じデータ区画を参照するすべてのキーの集合。

論理装置 (logical unit (LU)). アプリケーション・プログラムが別のアプリケーション・プログラムと通信するために SNA ネットワークにアクセスする、アクセス・ポイント。

論理データ・モデル化 (logical data modeling). 広範囲のビジネス情報を、正確で一貫性のある形式で文書化する処理。データ・モデル化は、データベースの設計の最初の作業となる。

論理的コンプリート (logically complete). コピー中のターゲット・オブジェクトを初期化して並行コピー処理が終了している状態。ターゲット・オブジェクトは、更新時に使用できる。

論理ドレーン (logical drain). 非区分化索引の論理区画のドレーン。

論理ページ・リスト (logical page list (LPL)). エラーが発生して、リカバリーされるまでアプリケーションでは参照できないページのリスト。このページは、実メディア (カップリング・ファシリティーまたはディスク)


||||

|||||

||||

にはエラーがない可能性があるので、論理エラーの状態である。通常、メディアへの接続は失われている。

論理リカバリー保留 (logical recovery pending

(LRECP)). 矛盾するデータを参照するデータと索引キーの状態。

論理ロック (L ロック)(logical lock (L-lock)). トランザクション間で DB2 内および DB2 間のデータ並行性を制御するためにトランザクションが使用するロック・タイプ。物理ロック (P ロック)(physical lock (P-lock)) と比較。

［ワ行］割り当てカーソル (allocated cursor). カーソルの 1 つであり、SQL ALLOCATE CURSOR ステートメントを使用することにより、ストアード・プロシージャー結果セットに対して定義される。

［数字］1 次許可 ID (primary authorization ID). DB2 へのアプリケーション・プロセスを識別するために使用する許可 ID。

1 次グループ・バッファー・プール (primary group

buffer pool). 二重グループ・バッファー・プールに対して、キャッシュ・データの保守に使用される構造。この構造は、ページ登録および相互無効化に使用される。z/OS では、旧構造がこれと同等。2 次グループ・バッファー・プール (secondary group buffer pool) と比較。

1 次索引 (primary index). 基本キーの一意性を強める索引。

1 バイト文字セット (single-byte character set

(SBCS)). 各文字が 1 バイトで表現される文字のセット。 2 バイト文字セット (double-byte character set) またはマルチバイト文字セット (multibyte character set)

と比較。

2 次許可 ID (secondary authorization ID). 許可出口ルーチンによって 1 次許可 ID に結び付けられた許可ID。

2 次グループ・バッファー・プール (secondary group

buffer pool). 二重グループ・バッファー・プールの場合、1 次グループ・バッファー・プールに書き込まれている変更済みページのバックアップを行うために用いられる構造。 2 次グループ・バッファー・プール使用時に、ページ登録や相互無効化は行われない。 z/OS において同等となるものは新しい構造。

2 進整数 (binary integer). 基本データ・タイプの 1

つ。これは、さらに短精度整数と長精度整数に分類することができる。

2 進ラージ・オブジェクト (BLOB) (binary large

object). 値のサイズが 0 バイトから 2 GB-1 までの範囲の一連のバイト。このようなストリングの CCSID 値は 65535 です。

2 バイト文字セット (double-byte character set

(DBCS)). 単一バイトで表現できるよりも多くのシンボルを持つ、日本語や中国語などの各国語によって使用される文字のセット。それぞれの文字は、2 バイトの長さになる。 1 バイト文字セット (single-byte character set)

およびマルチバイト文字セット (multibyte character set)

と比較。

2 バイト文字ラージ・オブジェクト (double-byte

character large object (DBCLOB)). 値のサイズが最大2 GB まで可能な、2 バイト文字を表す一連のバイト。一般に、DBCLOB 値は 2 バイト文字ストリングがVARGRAPHIC タイプの限界を超える可能性がある場合に使用される。

3 パート名 (three-part name). 表、視点、もしくは別名の名前。ピリオドで区切られたロケーション名、許可 ID、およびオブジェクト名から構成される。

A

ANSI. 米国規格協会 (American National Standards

Institute)。

APAR. プログラム診断依頼書 (Authorized program

analysis report)。

APAR 固定訂正サービス (APAR fix corrective

service). IBM ソフトウェアの障害の一時的な訂正。通常、プログラム一時修正 (PTF) などのより永続的な訂正によって後日置換されるので、この訂正は一時的なものである。

APF. 許可プログラム機能 (Authorized program

facility)。

API. アプリケーション・プログラミング・インターフェース (Application programming interface)。

APPL. SNA LU 6.2 プロトコルを使用する 1 つのアプリケーション・プログラムとして DB2 を VTAM に定義するために使用される VTAM ネットワーク定義ステートメント。

用語集 513

####

ASCII. 一般的に PC およびワークステーションなどの多くの環境でストリングを表現するために使用されるエンコード・スキーム。 EBCDIC およびユニコード(Unicode) と比較。

ASID. アドレス・スペース ID。

B

BEFORE トリガー (before trigger). トリガー起動時間に BEFORE を指定して定義されたトリガー。

BLOB. 2 進ラージ・オブジェクト (Binary large

object)。

BMP. バッチ・メッセージ処理 (Batch Message

Processing) (IMS の場合)。バッチ・メッセージ処理プログラム (batch message processing program) を参照してください。

BSAM. 基本順次アクセス方式 (Basic sequential access

method)。

BSDS. ブートストラップ・データ・セット (Bootstrap

data set)。

C

CAF. 呼び出し接続機能 (Call attachment facility)。

CASE 式 (CASE expression). 1 つ以上の条件の評価に基づいて選択された式。

cast 関数 (cast function). データ・タイプのインスタンス (ソース) を別のデータ・タイプのインスタンス (ターゲット) に変換する際に用いられる関数。一般的に、cast 関数には、ターゲット・データ・タイプの名前が付く。この関数には、タイプがソース・データ・タイプの単一の引数があり、リターン・タイプはターゲット・データ・タイプである。

CCSID. コード化文字セット ID (Coded character set

identifier)。

CDB. 通信データベース (Communications database)。

CDRA. 文字データ表示体系 (Character Data

Representation Architecture)

CEC. 中央電子複合システム (Central electronic

complex)。中央処理装置複合システム (central processor

complex) を参照。

CFRM. カップリング・ファシリティー・リソース管理(Coupling facility resource management)

CFRM ポリシー (CFRM policy). カップリング・ファシリティー構造の割り振り規則に関する z/OS 管理担当者による宣言。

CI. 制御インターバル (Control Interval)。

CICS. 本資料では以下を表す。CICS Transaction Server

for z/OS: Customer Information Control System

Transaction Server for z/OS。

CICS 接続機能 (CICS attachment facility). CICS からDB2 への要求を処理し、リソース・コミットメントを調整するために、z/OS サブシステム・インターフェース (SSI) とクロスストレージ・リンケージを使用するDB2 サブコンポーネント。

CIDF. 制御インターバル定義フィールド (Control

interval definition field)。

CLI. コール・レベル・インターフェース (Call-level

interface)

CLIST. コマンド・リスト (Command list)。 TSO タスクを実行するための言語。

CLOB. 文字ラージ・オブジェクト (Character large

object)。

CLPA. リンク・パック域の作成 (Create Link Pack

Area)。

CP. 中央処理装置 (central processor)

CPC. 中央処理装置複合システム (central processor

complex)。

CRC. コマンド認識文字 (Command recognition

character)。

CRCR. 条件付き再始動制御レコード (conditional

restart control record)。条件付き再始動 (conditional

restart) も参照。

CS. カーソル固定 (cursor stability)。

CSA. 共通サービス域 (common service area)。

CT. カーソル表 (cursor table)。

C++ オブジェクト (C++ object). (1) ストレージの領域。変数が定義されたとき、または新規に関数が呼び出されたときにオブジェクトが作成される。 (2) クラスのインスタンス。

C++ メンバー (C++ member). 構造体、共用体、またはクラス内のデータ・オブジェクトまたは関数。


|

||

|||

C++ メンバー関数 (C++ member function). クラスのメンバーとして宣言される演算子または関数。メンバー関数は、プライベート・データと保護データのメンバー、およびそのクラスのオブジェクトのメンバー関数へのアクセス権を持つ。メンバー関数はメソッドとも呼ばれる。

D

DAD. document access definition を参照。

DB2 PM. DB2 パフォーマンス・モニター。

DB2 (VSE および VM 版) (DB2 for VSE & VM).

VSE および VM オペレーティング・システム用 IBM

DB2 リレーショナル・データベース管理システム。

DB2 カタログ (DB2 catalog). DB2 により維持管理され、表、視点、および索引などの DB2 オブジェクトの記述が入っている表。

DB2 間 R/W インタレスト (inter-DB2 R/W interest).

表スペース、索引、または区画のデータの特性。データ共用グループの複数のメンバーによってオープンされ、そのうち少なくとも 1 人のメンバーが書き込みでオープンしている。

DB2 コマンド (DB2 command). DB2 を開始または停止する、現行ユーザーに関する情報を表示する、データベースを開始または停止する、データベースの状況に関する情報を表示するなどのためにユーザーが入力するDB2 サブシステムへの命令。

DB2 スレッド (DB2 thread). アプリケーションの接続を記述し、その過程をトレースしてリソース機能を処理し、さらにその DB2 リソースとサービスへのアクセス可能性の範囲を定める DB2 構造。

DB2 対話機能 (DB2 Interactive (DB2I)). SQL ステートメント、DB2 (オペレーター) コマンド、プログラマー・コマンドならびにユーティリティー呼び出しを実行するための DB2 機能。

DB2I. DB2 対話機能 (DB2 interactive)。

DB2I 漢字フィーチャー (DB2I Kanji Feature). DB2I

パネルを漢字で表示できるようにするパネルとジョブを収めているテープ。

DBA. データベース管理者 (database administrator)。

DBCLOB. 2 バイト文字ラージ・オブジェクト(double-byte character large object)。

DBCS. 2 バイト文字セット (double-byte character

set)。

DBD. データベース記述子 (database descriptor)。

DBID. データベース ID (database identifier)。

DBMS. データベース管理システム (database

management system)。

DBRM. データベース要求モジュール (database request

module)。

DCLGEN. 宣言生成プログラム (declarations

generator)。

DD 名 (ddname). データ定義名。

DDF. 分散データ機能 (distributed data facility)。

DES ベース・オーセンティケーター (DES-based

authenticator). DES アルゴリズムを使用して生成されるオーセンティケーター。

deterministic 関数 (deterministic function). ユーザー定義関数の 1 つであり、その結果は、入力引数の値によって決まる。つまり、同じ入力値を使用して引き続き行われる呼び出しで、同じ応答を生成する。非可変(not-variant) 関数とも呼ばれる。 nondeterministic 関数(nondeterministic function) (可変関数 (variant function)とも呼ばれる) と違い、同一の入力に対し常に同じ結果を生成するとは限らない。

DFP. データ機能プロダクト (z/OS の場合)。

DFSMS. データ機能ストレージ管理サブシステム(z/OS の場合)。ストレージ管理サブシステム (Storage

Management Subsystem (SMS)) とも呼ばれる。

DFSMSdss™. DFSMS のデータ・セット・サービス(DSS)・コンポーネント (z/OS の場合)。

DFSMShsm™. DFSMS の階層ストレージ・マネージャー (hsm)・コンポーネント (z/OS の場合)。

DISTINCT 述部 (distinct predicate). SQL で、2 行の値が等しくなく、両方の行の値が NULL でないことを確認する述部。

DL/I. データ言語 /I (Data Language/I)。

DNS. ドメイン・ネーム・サーバー (domain name

server)。

Document Access Definition (DAD). XML 列のスキームの索引付け、または XML コレクションのスキームのマッピングを定義するために使用される。 XML フォー

用語集 515

|

||

||

###

|||

マットされた XML コレクションの XML 拡張列を使用可能にするためにも使用できる。

DPSI. データ区分化副次索引。

DRDA. 分散リレーショナル・データベース体系(Distributed Relational Database Architecture)。

DRDA アクセス (DRDA access). 以前にサーバー・ロケーションでバインドされているパッケージを実行するために別のデータベース・サーバーに接続する際に使用することができる、分散データにアクセスするオープン方式。 SQL CONNECT ステートメントまたは 3 部分名を指定した SQL ステートメントを使用して、サーバーを識別する。プライベート・プロトコル・アクセス(private protocol access) と比較。

DSN. (1) デフォルトの DB2 サブシステム名。 (2)

DB2 の TSO コマンド処理プログラム名。 (3) DB2 のモジュールおよびマクロ名の先頭 3 文字。

E

EA 使用可能表スペース (EA-enabled table space). 拡張アドレッシング機能用として使用可能にされ、4 GB

より大きい個々の区画 (LOB 表スペースの場合は断片)

を含む表スペースまたは索引スペース。

EB. エクサバイト (exabyte) を参照。

EBCDIC. 拡張 2 進化 10 進コード (extended binary

coded decimal interchange code)。 z/OS、VM、VSE、および iSeries™ 環境で文字データを表すために使用するコード化スキーム。ASCII およびユニコード (Unicode)

と比較。

EDM プール (EDM pool). データベース記述子、アプリケーション・プラン、許可キャッシュ、アプリケーション・パッケージに使用される主ストレージのプール。

EID. イベント ID (event identifier)。

EOM. メモリーの終了 (end of memory)。

EOT. タスクの終了 (end of task)。

equijoin. 結合条件に、式 = 式という形式がある結合操作。

ESDS. 入力順データ・セット (Entry sequenced data

set)。

ESMT. 外部サブシステム・モジュール表 (IMS の場合)。

EUR. IBM 欧州標準規格。

Extensible MarkupLanguage (XML). マークアップ言語を定義する標準メタ言語で、Standardized General

Markup Language (SGML) のサブセット。XML は複雑ではないので、文書タイプを扱うアプリケーションの書き込み、構造化された情報の作成および管理、また、構造化された情報を多様なコンピューター環境において送信、共有することが容易になる。

e-business. インターネット・テクノロジーを使用して、主要なビジネス・プロセスを変化させること。

F

FlashCopy. アプリケーションの実行中にデータのポイント・イン・タイム・コピーを作成できる、IBM

Enterprise Storage Server® 上の機能。

forest. XML ノードのサブツリーの順序セット。

forget. 2 フェーズ・コミット操作では、(1) 参加プログラムがどのデータも変更していない場合に、準備フェーズに送られる断定。 forget 決定により、参加プログラムは作業論理単位に関してロックを解放し、忘れる(forget) ことができる。これは読み取り専用決定とも呼ばれる。 (2) 操作の 2 番目のフェーズにおけるコミット要求への応答。

G

GB. ギガバイト (1 073 741 824 バイト)。

GBP. グループ・バッファー・プール (group buffer

pool)。

GBP 従属 (GBP-dependent). グループ・バッファー・プールに従属するページ・セットまたはページ・セット区画の状況。このページ・セットの DB2 サブシステムの間で読み取り/書き込みインタレストがアクティブである状態、またはそのページ・セットが、まだディスクにキャストアウトされていないグループ・バッファー・プールの中に変更されたページを持っている状態のいずれか。

GTF. 汎用トレース機能 (generalized trace facility)。

H

HSM. 階層記憶管理プログラム (hierarchical storage

manager)。

HTML. ハイパーテキスト・マークアップ言語(Hypertext Markup Language)。Web データをユーザーに提供するための標準の方式。


||

|

|||

|

HTTP. Hypertext Transfer Protocol。Web が使用する通信プロトコル。

I

ICF. 統合カタログ機能 (integrated catalog facility)。

IDCAMS. アクセス方式サービス・コマンドを処理するために使用される IBM プログラム。この呼び出しは、TSO 端末またはユーザー・アプリケーション・プログラム内から、ジョブもしくはジョブ・ステップとして行うことができる。

IDCAMS LISTCAT. アクセス方式サービス・カタログに含まれる情報を入手するための機能。

IFCID. 計測機能コンポーネント ID (instrumentation

facility component identifier)。

IFI. 計測機能インターフェース (instrumentation facility

interface)。

IFI 呼び出し (IFI call). 定義した関数の 1 つによる、計測機能インターフェース (IFI) の呼び出し。

IFP. IMS 高速機能。

IMS. 情報管理システム (Information Management

System)。

IMS DB. 情報管理システム・データベース(Information Management System Database)。

IMS TM. 情報管理システム・トランザクション・マネージャー (Information Management System Transaction

Manager)。

IMS 接続機能 (IMS attachment facility). A IMS からDB2 への要求を処理しリソース・コミットメントを調整するために z/OS サブシステム・インターフェース(SSI)・プロトコルとクロスメモリー・リンケージを使用する DB2 サブコンポーネント。

IP アドレス (IP address). TCP/IP ホストを固有に識別する 4 バイトの値。

IRLM. 内部リソース・ロック・マネージャー (internal

resource lock manager)。

ISO. 国際標準化機構 (International Organization for

Standardization)。

ISPF. 対話式システム生産性向上機能 (Interactive

System Productivity Facility)。

ISPF/PDF. 対話式システム生産性向上機能 / プログラム開発機能 (Interactive System Productivity Facility/

Program Development Facility)。

J

JAR. Java アーカイブ。

Java アーカイブ (JAR). 多くのファイルを単一のファイルに集めるために使用されるファイル・フォーマット。

JCL. ジョブ制御言語 (job control language)。

JDBC. Java 用の Sun Microsystems のデータベース・アプリケーション・プログラミング・インターフェース(API) であり、プログラムは、呼び出し可能 SQL を使用することによってデータベース管理システムをアクセスできる。 JDBC では、SQL プリプロセッサーを使用する必要はない。さらに、JDBC は、ユーザーがデータベース・ドライバーと呼ばれるモジュールを追加できる体系を提供している。このドライバーは、実行時にアプリケーションをデータベース管理システムのユーザーの選択項目にリンクする。

JES. ジョブ入力サブシステム。

JIS. 日本工業規格 (Japanese Industrial Standard)。

K

KB. キロバイト (1024 バイト)。

Kerberos. 秘密鍵暗号を使用してクライアント/サーバーのアプリケーションに対する強力な認証を提供するために設計されたネットワーク認証プロトコル。

Kerberos チケット (Kerberos ticket). 開始しているプリンシパルを識別したことをその宛先に送信する透過アプリケーション・メカニズム。単一のチケットには、宛先の機密キーによって封印された、プリンシパルのID、セッション・キー、タイム・スタンプ、およびその他の情報が含まれる。

KSDS. キー順データ・セット (Key-sequenced data

set)。

L

L ロック (L-lock). 論理ロック (logical lock)。

LCID. ログ制御間隔定義 (log control interval

definition)。

用語集 517

|

LDS. 線形データ・セット (linear data set)。

LLE. ロード・リスト・エレメント (load list

element)。

LOB. ラージ・オブジェクト (large object)。

LOB 表スペース (LOB table space). 関連する基本表の中の特定の LOB 列についてのすべてのデータが入っている補助表内の表スペース。

LOB ロケーター (LOB locator). アプリケーション・プログラムがデータベース・システム内のラージ・オブジェクト値を操作できるようにする機構。 LOB ロケーターは、単一の LOB 値を表すフルワードの整数値。アプリケーション・プログラムは、LOB ロケーターをリトリーブしてホスト変数の中に入れてから、そのロケーターを使用して、関連する LOB 値に SQL 操作を適用することができる。

LOB ロック (LOB lock). LOB 値に対するロック。

LPL. 論理ページ・リスト (logical page list)。

LRECP. 論理リカバリー保留 (logical recovery

pending)。

LRH. ログ・レコード・ヘッダー (log record header)。

LRSN. ログ・レコード・シーケンス番号 (log record

sequence number)。

LU. 論理装置。

LU 名 (LU name). 論理装置名であり、VTAM がネットワーク内のノードを参照するための名前である。ロケーション名 (location name) と比較。

LUW. 作業論理単位 (logical unit of work)。

LUWID. 作業論理単位 ID (logical unit of work

identifier)。

M

MB. メガバイト (1 048 576 バイト)。

MBCS. マルチバイト文字セット (multibyte character

set)。 UTF-8 は MBCS の 1 つの例である。 UTF-8 の文字は、 DB2 では 1 ～ 4 バイトにすることができる。

MLPA. 修正済みリンク・パック域 (modified link pack

area)。

MODEENT. ログオン・モード名とセッション・プロトコルを表す 1 組のパラメーターとを関連付ける

VTAM マクロ命令。 MODEENT マクロ命令の集合はログオン・モード表を定義する。

MPP. メッセージ処理プログラム (IMS の場合)。

MTO. マスター端末オペレーター (master terminal

operator)。

mutex. Pthread 相互排他、すなわち、ロック。 Pthread

mutex 変数は、一時的に 1 つのスレッド以外のすべての実行をブロック化することにより、コードのクリティカル・セクションの逐次使用化を可能にするロッキング機構として用いられる。

MVS. 多重仮想記憶 (Multiple Virtual Storage) を参照。

N

NID. ネットワーク ID。

NPSI. 非区分化副次索引 (nonpartitioned secondary

index)。

NRE. ネットワーク・リカバリー・エレメント(network recovery element)。

NUL. 値 X'00' で表されるヌル文字 (’\0’)。 C では、この文字はストリングの終了を表示する。

NULLIF. 渡された 2 つの式を評価するスカラー関数。引数が等しい場合は NULL を戻し、等しくない場合は最初の引数の値を戻す。

O

OASN (origin application schedule number). IMS では、IMS の最新のコールド・スタート時に、各 IMS スケジュールに順次割り当てられる 4 バイトの番号。OASN は、作業単位の ID として使用される。 8 バイト・フォーマットでは、最初の 4 バイトにはスケジュール番号が入り、後の 4 バイトには現行スケジュール時の IMS 同期点 (コミット・ポイント) の数が入る。OASN は、IMS 接続の NID の一部である。

OBID. データ・オブジェクト ID (data object

identifier)。

ODBC. Open Database Connectivity。

ODBC ドライバー (ODBC driver). ODBC 機能呼び出しを実行し、データ送信装置と対話する、ダイナミック・リンク・ライブラリー (DLL)。


||

||

Open Database Connectivity (ODBC). Microsoft® データベース・アプリケーション・プログラミング・インターフェース (API) であり、呼び出し可能 SQL を使用してデータベース管理システムにアクセスすることができる。 ODBC では、SQL プリプロセッサーを使用する必要はない。さらに、ODBC は、ユーザーがデータベース・ドライバーと呼ばれるモジュールを追加できる体系を提供している。このドライバーは、実行時にアプリケーションをデータベース管理システムのユーザーの選択項目にリンクする。これは、サポートされているすべてのデータベース管理システムのモジュールに、アプリケーションを直接リンクする必要がないことを意味する。

OS/390. Operating System/390®。

P

P ロック (P-lock). 物理ロック (Physical lock)。

Parallel Sysplex. 顧客の作業負荷を処理するために、特定の複数システム・ハードウェア・コンポーネントおよびソフトウェア・サービスを介して互いに通信および調整を行う一連の z/OS システム。

PCT. プログラム制御表 (program control table) (CICS

の場合)。

PDS. 区分データ・セット (partitioned data set)。

PLT. プログラム・リスト表 (Program list table) (CICS

の場合)。

POSIX. ポータブル・オペレーティング・システム・インターフェース (Portable Operating System Interface)。

PPT. (1) 処理プログラム表 (processing program table)

(CICS の場合)。 (2) プログラム・プロパティー表(program properties table) (z/OS の場合)。

PSRCP. ページ・セット・リカバリー・ペンディング(page set recovery pending)。

PTF. プログラム一時修正 (program temporary fix)。

Pthread. アプリケーションをサブタスクに分割するための POSIX スレッド化標準モデル。 Pthread 標準には、スレッドの作成、スレッドの終了、ロッキングによるスレッドの同期化、およびその他のスレッド制御機能を実行するための機能が組み込まれている。

Q

QMF™. 照会報告書作成プログラム (Query

Management Facility)。

QSAM. 待機順次アクセス方式 (queued sequential

access method)。

R

RACF. リソース・アクセス制御機能 (Resource Access

Control Facility)。 z/OS セキュリティー・サーバーのコンポーネント。

RAMAC®. IBM ファミリーのエンタープライズ・ディスク・ストレージ・システム・プロダクト。

RBA. 相対バイト・アドレス (relative byte address)。

RCT. リソース管理表 (resource control table) (CICS 接続機能の場合)。

RDB. リレーショナル・データベース (relational

database)。

RDBMS. リレーショナル・データベース管理システム(relational database management system)。

RDBNAM. リレーショナル・データベース名(relational database name)。

RDF. レコード定義フィールド (record definition

field)。

RECFM. レコード・フォーマット (Record format)。

RECP. リカバリー保留中 (recovery pending)。

REORG 保留 (REORP) (REORG pending). 再編成が必要なオブジェクトに対する SQL アクセスおよび大部分のユーティリティー・アクセスを制限する条件。

REORP. REORG 保留 (REORG pending)。

RESTP. 再始動保留 (restart pending)。

RID. レコード ID (record identifier)。

RID プール (RID pool). レコード ID プール (Record

identifier pool)。

RLF. リソース限定機能 (resource limit facility)。

RLST. リソース限定表 (resource limit specification

table)。

RMID. リソース管理プログラム ID (resource manager

identifier)。

RO. 読み取り専用アクセス (read-only access)。

ROWID. 行 ID (row identifier)。

用語集 519

|||

rowset. カーソル位置が確立される行のセット。

rowset 位置アクセス (rowset-positionedaccess). 単一のFETCH ステートメントから複数の行を検索できる能力。

rowset カーソル (rowset cursor). 定義されたカーソル。1 つまたは複数の行が単一の FETCH ステートメントの rowset として戻すことができ、カーソルはフェッチされた行セット上に置かれる。

RRE. residual recovery entry (IMS の場合)。

RRSAF. リカバリー可能リソース管理プログラム・サービス接続機能 (Recoverable Resource Manager Services

attachment facility)。

RS. 読み取り固定 (read stability)。

RTT. リソース変換表 (resource translation table)。

RURE. URE の再実行。

S

SBCS. 1 バイト文字セット (single-byte character set)。

SCA. 共用連絡域 (shared communications area)。

SDWA. システム診断作業域 (system diagnostic work

area)。

SMF. システム管理機能 (System Management

Facility)。

SMP/E. システム修正変換プログラム (System

Modification Program/Extended)。

SMS. 記憶管理サブシステム (Storage Management

Subsystem)。

SNA. システム・ネットワーク体系 (Systems Network

Architecture)。

SNA ネットワーク (SNA network). システム・ネットワーク体系 (SNA) のフォーマットとプロトコルに適合するネットワークの部分。

SPUFI. ファイル入力式 SQL 処理プログラム (SQL

Processor Using File Input)。

SQL. 構造化照会言語 (Structured Query Language)。

SQL ID. SQL 許可 ID。

SQL 拡張文字 (SQL escape character). SQL 区切りID を囲むために使用されるシンボル。このシンボルは二重引用符 (") である。エスケープ文字 (escape

character) も参照。

SQL 関数 (SQL function). ユーザー定義関数の 1 つであり、その中の CREATE FUNCTION ステートメントにソース・コードが含まれる。ソース・コードは、単一の値になる単一の SQL 式である。 SQL ユーザー定義関数は 1 つのパラメーターだけを戻すことができる。

SQL 記述子域 (SQL descriptor area (SQLDA)). 入力変数、出力変数、もしくは結果表の列を記述する構造。

SQL 許可 ID (SQL ID) (SQL authorization ID (SQL

ID)). 一部の状態でのダイナミック SQL ステートメントを検査するために用いられる許可 ID。

SQL 処理会話 (SQL processing conversation). アプリケーションを介してまたは動的照会リクエスターによるDB2 データのアクセスを必要とする会話。

SQL ステートメント・コプロセッサー (SQL statement

coprocessor). DB2 プリコンパイラーの代替となるものであり、コンパイル時にユーザーが SQL ステートメントを処理できるようにする。ユーザーは、コンパイラー・オプションを指定することにより SQL ステートメント・コプロセッサーを呼び出す。

SQL ストリング区切り文字 (SQL string delimiter).

SQL ストリング定数を囲むために使用されるシンボル。 SQL ストリング区切り文字は、COBOL アプリケーション以外では二重引用符 (') である。 COBOL アプリケーションの場合はユーザーが割り当てたシンボルであり、二重引用符かアポストロフィ (") のいずれかになる。

SQL 接続 (SQL connection). アプリケーション処理とローカルまたはリモート・アプリケーション・サーバーあるいはデータベース・サーバーの間のアソシエーション。

SQL パス (SQL path). ユーザー定義関数、特殊タイプ、およびストアード・プロシージャーに対する非修飾参照の解決に使用されるスキーマ名の番号付きリスト。ダイナミック SQL の場合は、CURRENT PATH 特殊レジスターで検出される現行パス。静的 SQL の場合は、PATH バインド・オプションで定義される。

SQL プロシージャー (SQL procedure). SQL CALL ステートメントを使用して呼び出すことができるユーザー作成プログラム。外部プロシージャー (external

procedure) と比較。


|

SQL リターン・コード (SQL return code). SQLCODE

または SQLSTATE。

SQL ルーチン (SQL routine). SQL で書かれたコードに基づくユーザー定義関数またはストアード・プロシージャー。

SQL 連絡域 (SQL communication area (SQLCA)). アプリケーション・プログラムにその SQL ステートメントの実行についての情報を提供するために使用される構造。

SQLCA. SQL 連絡域 (SQL communication area)。

SQLDA. SQL 記述子域 (SQL descriptor area)。

SQLJ. Java プログラム言語に組み込まれた構造化照会言語 (SQL)。

SRB. サービス要求ブロック (Service request block)。

SSI. サブシステム・インターフェース (z/OS の場合)。

SSM. サブシステム・メンバー (subsystem member)

(IMS の場合)。

SVC ダンプ (SVC dump). z/OS または DB2 機能のリカバリー・ルーチンがエラーを検出するときに出されるダンプ。

SYS1.DUMPxx データ・セット (SYS1.DUMPxx data

set). システム・ダンプが入っているデータ・セット(z/OS の場合)。

SYS1.LOGREC. プログラムおよびハードウェア・エラーについての重要な情報が入っている保守援助プログラム (z/OS の場合)。

Sysplex. Parallel Sysplex も参照。

System Modification Program/Extended(SMP/E). DB2

などのプログラミング・システムにおいてソフトウェアの変更を行い、それらの変更を制御するための z/OS ツール。

T

TB. テラバイト (Terabyte (1 099 511 627 776 バイト))。

TCB. タスク制御ブロック (task control block (z/OS の場合))。

TCP/IP. 通信リンク上で情報を交換するためにコンピューター・システムが使用するネットワーク通信プロトコル。

TCP/IP ポート (TCP/IP port). エンド・ユーザーまたは TCP/IP ホスト内の TCP/IP ネットワーク・アプリケーションを識別するための 2 バイトの値。

Time-Sharing Option (TSO). リモート端末からの対話式タイム・シェアリングを提供する MVS のオプション。

TMP. 端末モニター・プログラム (Terminal Monitor

Program)。

TSO. タイム・シェアリング (Time-Sharing Option)。

TSO 接続機能 (TSO attachment facility). DSN コマンド処理プログラムおよび DB2I から構成される DB2 機能。CICS または IMS 環境用として作成されていないアプリケーションを、TSO 接続機能の下で実行することができる。

U

UCS-2. 2 オクテットでコード化された (つまり、文字が 16 ビット / 文字で表される) 汎用文字セット。

UDF. ユーザー定義関数

UDT. ユーザー定義データ・タイプ (User-defined data

type)。 DB2 UDB for z/OS では、ユーザー定義データ・タイプに替わり、特殊タイプ (distinct type) という用語が使用される。特殊タイプ (distinct type) を参照。

uniform resource locator (URL). Web 上の特定の項目に名前を付け、その場所を示すための方法を提供するWeb アドレス。

UR. 非コミット読み取り (uncommitted read)。

URE. リカバリー単位のエレメント (unit of recovery

element)。

URID. リカバリー単位 ID (unit of recovery identifier)

URL. uniform resource locator。

UTF-16. 16 ビットのエンコード方式のユニコード・トランスフォーメーション・フォーマット。 100 万文字を超えるコード値を提供するために設計され、UCS-2 のスーパーセットである。 UTF-16 フォーマットでのデータの CCSID 値は 1200 である。 DB2 UDB for z/OS

は、グラフィック・データ・フィールドで UTF-16 をサポートしている。

用語集 521

UTF-8. 8 ビットのエンコード方式のユニコード・トランスフォーメーション・フォーマット。既存の ASCII

ベースのシステムで容易に使用できるよう設計されている。 UTF-8 フォーマットでのデータの CCSID 値は1208 である。 DB2 UDB for z/OS は、混合データ・フィールドで UTF-8 をサポートしている。

UUID. ユニバーサル固有 ID (Universal Unique

Identifier)。

V

Virtual Telecommunications AccessMethod (VTAM).

IBM ライセンス・プログラムの 1 つであり、SNA ネットワークにおける通信とデータの流れを制御する(z/OS の場合)。

VSAM. 仮想記憶アクセス方式 (Virtual Storage Access

Method)。

VTAM. 仮想通信アクセス方式 (Virtual

Telecommunication Access Method) (z/OS) の場合。

W

WLM アプリケーション環境 (WLM application

environment). 1 つまたは複数のストアード・プロシージャーに関連する z/OS ワークロード・マネージャー属性。 WLM アプリケーション環境によって、指定された DB2 ストアード・プロシージャーを実行するアドレス・スペースを判別する。

WTO. オペレーター向け書き込み (Write to operator)。

WTOR. 要応答オペレーターへの書き込み (Write to

operator (WTO) with reply)。

X

XCF. システム共通カップリング・ファシリティー(cross-system coupling facility) を参照。

XES. システム共通拡張サービス (cross-system extended

services) を参照。

XML. Extensible Markup Language を参照。

XML エレメント (XML element). 開始および終了タグにより区切られた XML 文書内の論理構造。開始タグと終了タグの間のすべてのものがエレメントの内容である。

XML 公開関数 (XML publishingfunctions). SQL 値から XML 値を戻す機能。

XML 属性 (XML attribute). エレメントの特定の機能を変更するタグ XML エレメント内の名前値のペア。

XML ノード (XML node). 文書内で有効かつ完全な構造の最小単位。例えば、ノードはエレメント、属性、またはテキスト・ストリングになり得る。

XRF. 拡張リカバリー機能 (extended recovery

facility)。

X/Open. 世界で最も大規模な情報システム提供者、ユーザー組織、ソフトウェア会社のほとんどによってサポートされている、独立した、世界規模のオープン・システムの組織。 X/Open の目的は、既存と新出の標準を統合することによってアプリケーションのポータビリティーを強化することである。

Z

z/OS 分散コンピューティング環境 (z/OS Distributed

Computing Environment (z/OS DCE)). 分散コンピューティングをインプリメントするために、オープン・ソフトウェア・ファウンデーションによって提供される 1 組のテクノロジー。


|

####

||

||

参考文献DB2 Universal Database for z/OS バージョン 8製品情報:

v DB2 管理者ガイド, SC88-9806

v DB2 アプリケーション・プログラミングおよびSQL ガイド, SC88-9808

v DB2 アプリケーション・プログラミングおよびJava リファレンス, SC88-9807

v DB2 コード, GC88-4062

v DB2 コマンド解説書, SC88-9809

v DB2 Common Criteria Guide, SC18-9672

v DB2 データ共用: 計画および管理, SC88-9810

v DB2 Diagnosis Guide and Reference, LY37-3201

v DB2 Diagnostic Quick Reference Card,

LY37-3202

v DB2 Image, Audio, and Video Extenders

Administration and Programming, SC18-7429

v DB2 インストール・ガイド, GC88-9811

v DB2 Licensed Program Specifications, GC18-7420

v DB2 Management Clients Package Program

Directory, GI10-8567

v DB2 メッセージ, GC88-4061

v DB2 ODBC ガイドおよび解説書, SC88-9814

v The Official Introduction to DB2 UDB for z/OS

v DB2 Program Directory, GI10-8566

v DB2 RACF アクセス・コントロール・モジュール・ガイド, SC88-9841

v DB2 リモート DRDA リクエスターおよびサーバー解説書, SC88-9815

v DB2 Reference Summary, SX26-3853

v DB2 リリース計画ガイド, SC88-9816

v DB2 SQL 解説書, SC88-9817

v DB2 Text Extender Administration and

Programming, SC18-7430

v DB2 ユーティリティー・ガイドおよび解説書,

SC88-9818

v DB2 新機能, GC88-9819

v DB2 XML エクステンダー管理とプログラミングの手引き, SC88-9822

関連製品についての資料およびリソース:

APL2®

v APL2 Programming Guide, SH21-1072

v APL2 プログラミング: 言語解説書, SH88-7015

v APL2 プログラミング: 構造化照会言語 (SQL)

の使用, SH88-7014

BookManager® READ/MVSv BookManager READ/MVS V1R3: Installation

Planning & Customization, SC38-2035

C 言語: IBM C/C++ for z/OSv z/OS C/C++ プログラミング・ガイド,

SC88-8849

v z/OS C/C++ ランタイム・ライブラリー・リファレンス, SA88-8515

文字データ表示体系v Character Data Representation Architecture

Overview, GC09-2207

v Character Data Representation Architecture

Reference and Registry, SC09-2190

CICS Transaction Server for z/OS

以下の資料番号は、バージョン 2 リリース 2 およびバージョン 2 リリース 3 の番号です (リリース 2 の資料番号が最初にリストされています)。v CICS Transaction Server for z/OS Information

Center, SK3T-6903 または SK3T-6957

v CICS Transaction Server for z/OS アプリケーション・プログラミング・ガイド, SC88-9047 または SC88-9630

v CICS Transaction Server for z/OS 適用業務プログラミング解説書, SC88-9048 またはSC88-9631

v CICS Transaction Server for z/OS CICS-RACF

Security Guide, SC34-6011 または SC34-6249

v CICS Transaction Server for z/OS CICS Supplied

Transactions, SC34-5992 または SC34-6230

v CICS Transaction Server for z/OS カスタマイズ・ガイド, SC88-9044 または SC88-9627


v CICS Transaction Server for z/OS Data Areas,

LY33-6100 または LY33-6103

v CICS Transaction Server for z/OS DB2 ガイド,

SC88-9071 または SC88-9638

v CICS Transaction Server for z/OS 外部インターフェース・ガイド, SC88-9050 またはSC88-9635

v CICS Transaction Server for z/OS 導入の手引き,

GC88-9043 または GC88-9626

v CICS Transaction Server for z/OS 相互通信ガイド, SC88-9049 または SC88-9634

v CICS Transaction Server for z/OS Messages and

Codes, GC34-6003 または GC34-6241

v CICS Transaction Server for z/OS 操作およびユーティリティーの手引き, SC88-9046 またはSC88-9629

v CICS Transaction Server for z/OS Performance

Guide, SC34-6009 または SC34-6247

v CICS Transaction Server for z/OS Problem

Determination Guide, SC34-6002 またはSC34-6239

v CICS Transaction Server for z/OS リリース・ガイド, GC88-9041 または GC88-9620

v CICS Transaction Server for z/OS 資源定義の手引き, SC88-9045 または SC88-9628

v CICS Transaction Server for z/OS System

Definition Guide, SC34-5988 または SC34-6226

v CICS Transaction Server for z/OS System

Programming Reference, SC34-5595 またはSC34-6233

CICS Transaction Server for OS/390v CICS Transaction Server for OS/390 アプリケーション・プログラミング・ガイド, SC88-7689

v CICS Transaction Server for OS/390 DB2 ガイド, SD88-7035

v CICS Transaction Server for OS/390 外部インターフェース・ガイド, SD88-7026

v CICS Transaction Server for OS/390 リソース定義ガイド, SC88-7687

COBOL:v IBM COBOL 言語解説書, SC88-9117

v Enterprise COBOL for z/OS プログラミング・ガイド, SC88-9121

データベース設計

v DB2 for z/OS and OS/390 Development for

Performance Volume I by Gabrielle Wiorkowski,

Gabrielle & Associates, ISBN 0-96684-605-2

v DB2 for z/OS and OS/390 Development for

Performance Volume II by Gabrielle Wiorkowski,

Gabrielle & Associates, ISBN 0-96684-606-0

v Handbook of Relational Database Design by C.

Fleming and B. Von Halle, Addison Wesley,

ISBN 0-20111-434-8

DB2 管理ツール

v DB2 Administration Tool for z/OS User's Guide

and Reference (Web サイトwww.ibm.com/software/data/db2imstools/

library.html から入手可能)

DB2 Buffer Pool Analyzer for z/OS

v DB2 Buffer Pool Tool for z/OS User's Guide and

Reference, (Web サイト www.ibm.com/software/

data/db2imstools/ library.html から入手可能)

DB2 Connect™

v IBM DB2 Connect DB2 Connect Enterprise

Edition 概説およびインストール, GC88-9145

v IBM DB2 Connect DB2 Connect Personal Edition

概説およびインストール, GC88-9146

v IBM DB2 Connect ユーザーズ・ガイド,

SC88-9147

DB2 DataPropagator™

v DB2 Universal Database レプリケーションのガイドおよびリファレンス, SC88-9163

DB2 Performance Expert for z/OS バージョン 1

以下の資料は、DB2 Performance Expert ライブラリーに入っています。これらの資料の一部は、IBM DB2 Performance Expert for z/OS、IBM DB2

Performance Monitor for z/OS および DB2 Buffer

Pool Analyzer for z/OS についての情報を含んでいます。

v IBM DB2 Performance Expert for Multiplatforms,

Workgroups, and z/OS IBM DB2 Buffer Pool

Analyzer for z/OS Buffer Pool Analyzer for z/OS

Buffer Pool Analyzer ユーザーズ・ガイド,

SC88-9874


v IBM DB2 Performance Expert for z/OS IBM DB2

Performance Monitor for z/OS IBM Buffer Pool

Analyzer for z/OS インストールと構成,

SC88-9875

v IBM DB2 Performance Expert for Multiplatforms,

Workgroups, and z/OS IBM DB2 Performance

Monitor for z/OS IBM DB2 Buffor Pool Analyzer

for z/OS メッセージ , SC88-9876

v DB2 PE for z/OS ワークステーション・パフォーマンス・モニター, SC88-9877

v IBM DB2 Performance Expert for z/OS IBM DB2

Performance Monitor for z/OS ISPF パフォーマンス・モニター, SC88-9878

v OMEGAMON Program Directory, GI10-8549

v OMEGAMON Report Command Reference,

SC18-7977

v OMEGAMON Report Reference, SC18-7978

v Using IBM Tivoli OMEGAMON XE on z/OS,

GC32-9209

DB2 Query Management Facility (QMF) バージョン 8.1v DB2 Query Management Facility: DB2 QMF

High Performance Option User’s Guide for

TSO/CICS, SC18-7450

v DB2 Query Management Facility: DB2 QMF メッセージおよびコード, GC88-9835

v DB2 Query Management Facility: DB2 QMF 解説書, SC88-9834

v DB2 照会報告書作成プログラム DB2 QMF アプリケーション開発の手引きバージョン 8 リリース 1, SC88-9836

v DB2 Query Management Facility: DB2 QMF for

Windows および DB2 QMF for WebSphere の入門, SC88-9840

v DB2 Query Management Facility: Getting Started

with DB2 QMF Query Miner, GC18-7451

v DB2 Query Management Facility: TSO/CICS 用DB2 QMF インストールおよび管理の手引き,

GC88-9832

v DB2 Query Management Facility: DB2 QMF for

Windows および DB2 QMF for WebSphere 導入および管理, GC88-9839

v DB2 照会報告書作成プログラム DB2 QMF 入門 V8R1, GC88-9831

v DB2 Query Management Facility: DB2 QMF 使用の手引き, SC88-9833

v DB2 Query Management Facility: DB2 QMF

Visionary 開発者の手引き, SC88-8631

v DB2 Query Management Facility: DB2 QMF

Visionary 入門使用者の手引き, GC88-8612

DB2 Redbooks™

DB2 に関するすべての IBM Redbooks へのアクセスついては、IBM Redbooks Web ページwww.ibm.com/redbooks を参照してください。

DB2 Server (VSE および VM 版)v DB2 サーバー (VM 版): DBS ユーティリティー

, SC88-8641

DB2 Universal Database クロスプラットフォーム情報v IBM DB2 Universal Database SQL Reference for

Cross-Platform Development

(www.ibm.com/software/data/ developer/cpsqlref/

で入手可能)

DB2 Universal Database for iSeries

以下の資料は、www.ibm.com/iseries/infocenter から入手できます。v DB2 Universal Database for iSeries パフォーマンスおよび Query 最適化

v DB2 Universal Database for iSeries データベース・プログラミング

v DB2 Universal Database for iSeries SQL プログラミング

v DB2 Universal Database for iSeries SQL

Programming with Host Languages

v DB2 Universal Database for iSeries SQL

Reference

v DB2 Universal Database for iSeries 分散データ管理

v DB2 Universal Database for iSeries 分散データベース・プログラミング

DB2 Universal Database for Linux、UNIX および Windows:v DB2 Universal Database 管理ガイド: プランニング, SC88-9135

v DB2 Universal Database 管理ガイド: インプリメンテーション, SC88-9133

v DB2 Universal Database 管理ガイド: パフォーマンス, SC88-9134

参考文献 525

v DB2 Universal Database 管理 API リファレンス, SC88-9136

v DB2 Universal Database アプリケーション開発の手引きアプリケーションの構築および実行,

SC88-9137

v DB2 Universal Database コール・レベル・インターフェースガイドおよびリファレンス第 1

巻および第 2 巻, SC88-9159 および SC88-9160

v DB2 Universal Database コマンド・リファレンス, SC88-9140

v DB2 Universal Database SQL リファレンス第1 巻, SC88-9155

v DB2 Universal Database SQL リファレンス第2 巻, SC88-9156

装置サポート機能v Device Support Facilities User's Guide and

Reference, GC35-0033

DFSMS

以下の資料では、z/OS DFSMS、z/OS

DFSMSdfp™、z/OS DFSMSdss、z/OS DFSMShsm

および z/OS DFP を含むさまざまな DFSMS のコンポーネントについての情報が提供されています。v z/OS DFSMS カタログのためのアクセス方式サービス・プログラム, SC88-9109

v z/OS DFSMSdss ストレージ管理ガイド,

SC88-8983

v z/OS DFSMSdss ストレージ管理解説書,

SC88-8999

v z/OS DFSMShsm ユーザー所有のデータの管理,

SC88-9107

v z/OS DFSMSdfp: Using DFSMSdfp in the z/OS

Environment, SC26-7473

v z/OS DFSMSdfp Diagnosis Reference, GY27-7618

v z/OS DFSMS: システム管理ストレージのインプリメンテーション, SC88-9113

v z/OS DFSMS: Macro Instructions for Data Sets,

SC26-7408

v z/OS DFSMS: カタログの管理, SC88-8978

v z/OS MVS プログラム管理：ユーザーズ・ガイドおよび解説書, SA88-8688

v z/OS MVS プログラム管理: 拡張機能,

SA88-8689

v z/OS DFSMSdfp ストレージ管理リファレンス,

SC88-8974

v z/OS DFSMS: データ・セットの使用法,

SC88-9114

v DFSMS/MVS: Using Advanced Services ,

SC26-7400

v z/OS DFSMSdfp ユーティリティー, SC88-8979

DFSORT™

v DFSORT 適用業務プログラミングの手引き,

SC88-7061

v DFSORT 導入とカストマイズ, SC88-7163

分散リレーショナル・データベース体系™

v オープン・グループ技術標準 The Open Group

に関しては、現在、以下の DRDA 資料が Web

サイト www.opengroup.org を通じて入手できます。– Open Group Technical Standard, DRDA

Version 3 Vol. 1: Distributed Relational

Database Architecture

– Open Group Technical Standard, DRDA

Version 3 Vol. 2: Formatted Data Object

Content Architecture

– Open Group Technical Standard, DRDA

Version 3 Vol. 3: Distributed Data

Management Architecture

ドメイン・ネーム・システムv DNS and BIND, Third Edition, Paul Albitz and

Cricket Liu, O’Reilly, ISBN 0-59600-158-4

教育v IBM 教育オファリングについての情報は、Web

サイト http://www.ibm.com/software/sw-training/

から入手できます。v IBM 用語集は、IBM 用語集の Web サイト

www.ibm.com/ibm/terminology/index.html でご利用いただけます。

eServer™ zSeries®

v IBM eServer zSeries Processor Resource/System

Manager Planning Guide, SB10-7033

Fortran: VS Fortranv VS Fortran 第 2 版: 言語およびライブラリー解説書, N:SC26-4221

v VS Fortran Version 2: Programming Guide for

CMS and MVS, SC26-4222

高水準アセンブラー


v High Level Assembler for MVS and VM and VSE

Language Reference, SC26-4940

v High Level Assembler for MVS and VM and VSE

Programmer's Guide, SC26-4941

ICSFv z/OS ICSF 概説, SA88-8528

v Integrated Cryptographic Service Facility

Administrator's Guide, SA22-7521

IMS バージョン 8

IMS 製品情報は、www.ibm.com/ims にある IMS

ライブラリー Web ページで入手できます。v IMS 管理の手引き: システム, SD88-6263

v IMS 管理の手引き: トランザクション管理プログラム, SD88-6264

v IMS アプリケーション・プログラミング: データベース管理プログラム, SD88-6265

v IMS アプリケーション・プログラミング: 設計の手引き, SD88-6266

v IMS アプリケーション・プログラミング: トランザクション管理プログラム, SD88-6268

v IMS コマンド解説書, SD88-6270

v IMS カストマイズの手引き, SD88-6273

v IMS インストール第 1 巻: インストールおよび検証, GD88-6276

v IMS インストール第 2 巻: システム定義および調整, GD88-6277

v IMS メッセージおよびコード第 1 巻および第2 巻, GD88-6278 および GD88-6279

v IMS オープン・トランザクション管理アクセス手引き、Open Transaction Manager Access 手引きおよび解説書, SC88-8902

v IMS ユーティリティー解説書: システム,

SD88-6285

IMS Batch Terminal Simulator for z/OS についての一般情報は、Web サイト www.ibm.com/

software/data/db2imstools/ library.html で入手できます。

IMS DataPropagatorv IMS DataPropagator for z/OS Administrator's

Guide for Log, SC27-1216

v IMS DataPropagator: An Introduction,

GC27-1211

v IMS DataPropagator for z/OS Reference,

SC27-1210

ISPFv ISPF ダイアログ開発者ガイドとリファレンス

z/OS, SC88-8964

v 対話式システム生産性向上機能 (ISPF) メッセージおよびコード z/OS, SC88-8958

v ISPF 計画とカスタマイズ z/OS , GC88-8957

v z/OS ISPF ユーザーズ・ガイド第 1 巻および第 2 巻, SC88-8965 および SC88-8966

言語環境プログラム®

v Debug Tool for z/OS and OS/390 ユーザーズ・ガイドバージョン 3 リリース 1, SC88-9542

v Debug Tool for z/OS and OS/390 リファレンスとメッセージ, SC88-9543

v z/OS 言語環境プログラム概念, SA88-8555

v z/OS 言語環境プログラムカスタマイズ,

SA88-8552

v z/OS 言語環境プログラムデバッグガイド,

GA88-8548

v z/OS 言語環境プログラムプログラミング・ガイド, SA88-8549

v z/OS 言語環境プログラムプログラミング・リファレンス, SA88-8550

MQSeries®

v MQSeries アプリケーション・メッセージング・インターフェース, SC88-8704

v MQSeries for OS/390 概説および計画ガイド,

GC88-8615

v MQSeries for OS/390 システム・セットアップ・ガイド, SC88-8616

各国語サポートv National Language Design Guide Volume 1,

SE09-8001

v IBM National Language Support Reference

Manual Volume 2, SE09-8002

NetView®

v Tivoli NetView for z/OS インストール: 概説,

SC88-9319

v Tivoli NetView for z/OS ユーザーズ・ガイド,

GC88-9300

Microsoft ODBC

Microsoft ODBC についての情報は、http://msdn.microsoft.com/library/ でご覧いただけます。

参考文献 527

Parallel Sysplex ライブラリーv System/390 9672 Parallel Transaction Server,

9672 Parallel Enterprise Server, 9674 Coupling

Facility System Overview For R1/R2/R3 Based

Models, SB10-7033

v z/OS 並列シスプレックスアプリケーションのマイグレーション, SA88-8609

v z/OS 並列シスプレックス概要：シスプレックスにおけるデータ共用および並列処理の紹介,

SA88-8608

v z/OS Parallel Sysplex Test Report, SA22-7663

Parallel Sysplex Configuration Assistant

(www.ibm.com/s390/pso/psotool から入手可能)

PL/I: Enterprise PL/I for z/OSv IBM Enterprise PL/I for z/OS 言語解説書,

SC88-9126

v IBM Enterprise PL/I for z/OS プログラミング・ガイド, SC88-9123

PL/I: PL/I for MVS & VMv PL/I for MVS & VM Programming Guide,

SC26-3113

SMP/Ev z/OS SMP/E 解説書および OS/390 SMP/E 解説書, SA88-8624

v z/OS SMP/E ユーザーズ・ガイドおよび OS/390

SMP/E ユーザーズ・ガイド, SA88-8625

ストレージ管理v z/OS DFSMS: システム管理ストレージのインプリメンテーション, SC88-9113

v MVS/ESA Storage Management Library:

Managing Data, SC88-9110

v MVS/ESA Storage Management Library:

Managing Storage Groups, SC88-8981

v MVS Storage Management Library: Storage

Management Subsystem Migration Planning

Guide, SC26-4406

システム・ネットワーク体系 (SNA)v SNA Formats, GA27-3136

v SNA LU 6.2 Peer Protocols Reference,

SC31-6808

v SNA Transaction Programmer's Reference Manual

for LU Type 6.2, GC30-3084

v SNA/Management Services Alert Implementation

Guide, GC31-6809

TCP/IPv MVS 版 TCP/IP プログラム: カスタマイズと管理の手引き, SC88-7935

v IBM TCP/IP for MVS: Diagnosis Guide,

LY43-0105

v IBM TCP/IP for MVS: Messages and Codes,

SC31-7132

v IBM TCP/IP プログラム (MVS): 計画と移行の手引き, SC88-7937

TotalStorage™ Enterprise Storage Serverv RAMAC Virtual Array: Implementing Peer-to-Peer

Remote Copy, SG24-5680

v エンタープライズ・ストレージ・サーバー入門と計画のガイド, GD88-6248

v IBM TotalStorage エンタープライズ・ストレージ・サーバーモデル 800, SG88-6006

Unicode

v z/OS Support for Unicode: 変換サービスの使用,

SA88-8813

Unicode、ユニコード協会、Unicode 規格、および規格合致要件についての情報は、www.unicode.org

でご覧いただけます。

VTAMv Planning for NetView, NCP, and VTAM,

SC31-8063

v VTAM for MVS/ESA Diagnosis, LY43-0078

v VTAM for MVS/ESA Messages and Codes,

SC31-6493

v VTAM ネットワーク導入の手引き (MVS/ESA),

SC88-7567

v VTAM 操作解説書 (MVS/ESA 版), SC88-7572

v z/OS Communications Server SNA Programming,

SC31-8829

v z/OS Communicatons Server SNA Programmer's

LU 6.2 Reference, SC31-8810

v VTAM (MVS/ESA) 資源定義解説書, SC88-7577

WebSphere® ファミリーv WebSphere MQ Integrator Broker: Administration

Guide, SC34-6171

v WebSphere MQ Integrator Broker for z/OS:

Customization and Administration Guide,

SC34-6175

v WebSphere MQ Integrator Broker: 紹介および計画ガイド, GC88-8677


v WebSphere MQ Integrator Broker: コントロール・センターの使用法, SC88-9406

z/Architecture™

v z/Architecture 解説書, SA88-8773

z/OSv z/OS C/C++ プログラミング・ガイド,

SC88-8849

v z/OS C/C++ ランタイム・ライブラリー・リファレンス, SA88-8515

v z/OS C/C++ ユーザーズ・ガイド, SC88-8850

v z/OS Communications Server: IP 構成ガイド,

SC88-8926

v z/OS DCE 管理ガイド, SD88-6186

v z/OS DCE 入門, GD88-6191

v z/OS DCE メッセージおよびコード, SD88-6192

v z/OS 情報ロードマップ, SA88-8518

v z/OS 入門とリリース・ガイド, GA88-8519

v z/OS JES2 初期設定およびチューニングガイド,

SA88-8533

v z/OS JES3 初期設定およびチューニングガイド,

SA88-8543

v z/OS 言語環境プログラム概念, SA88-8555

v z/OS 言語環境プログラムカスタマイズ,

SA88-8552

v z/OS 言語環境プログラムデバッグガイド,

GA88-8548

v z/OS 言語環境プログラムプログラミング・ガイド, SA88-8549

v z/OS 言語環境プログラムプログラミング・リファレンス, SA88-8550

v z/OS Managed System Infrastructure for Setup ユーザーズ・ガイド, SD88-6260

v z/OS MVS 診断：手順, GA88-8559

v z/OS MVS 診断: 解説書, GA88-8560

v z/OS MVS 診断: ツールと補助援助プログラム,

GA88-8561

v z/OS MVS 初期設定およびチューニングガイド,

SA88-8567

v z/OS MVS 初期設定およびチューニング解説書,

SA88-8564

v z/OS MVS インストール・システム出口,

SA88-8565

v z/OS MVS JCL 解説書, SA88-8569

v z/OS MVS JCL ユーザーズ・ガイド, SA88-8570

v z/OS MVS 計画: グローバル・リソース逐次化,

SA88-8572

v z/OS MVS 計画: 操作, SA88-8573

v z/OS MVS 計画: ワークロード管理, SA88-8574

v z/OS MVS プログラミング: アセンブラー・サービス・ガイド, SA88-8577

v z/OS MVS プログラミング: アセンブラー・サービス解説書第 1 巻および第 2 巻, SA88-8578

v z/OS MVS Programming: Authorized Assembler

Services Guide, SA22-7608

v z/OS MVS Programming: Authorized Assembler

Services Reference Volumes 1-4,

SA22-7609、SA22-7610、SA22-7611 およびSA22-7612

v z/OS MVS Programming: Callable Services for

High-Level Languages, SA22-7613

v z/OS MVS Programming: Extended Addressability

Guide, SA22-7614

v z/OS MVS プログラミング: シスプレックス・サービス・ガイド, SA88-8583

v z/OS MVS プログラミング: シスプレックス・サービス解説書, SA88-8584

v z/OS MVS プログラミング: ワークロード管理サービス, SA88-8585

v z/OS MVS 回復と再構成ガイド, SA88-8589

v z/OS MVS 宛先コードおよび記述子コード,

SA88-8590

v z/OS MVS シスプレックスのセットアップ,

SA88-8591

v z/OS MVS システム・コード SA88-8592

v z/OS MVS システム・コマンド, SA88-8593

v z/OS MVS システム・メッセージ第 1 巻～第 10 巻, SA88-8597、SA88-8598、SA88-8599、SA88-8600、SA88-8601、SA88-8602、SA88-8603、SA88-8604、SA88-8605 およびSA88-8606

v z/OS MVS Using the Subsystem Interface,

SA22-7642

v z/OS Planning for Multilevel Security and the

Common Criteria, SA22-7509

v z/OS RMF ユーザーズ・ガイド, SD88-6181

v z/OS Integrated Security Services ネットワーク認証サービス管理ガイド, SD88-6203

v z/OS Security Server RACF 監査担当者のガイド,

SA88-8614

v z/OS Security Server RACF コマンド言語解説書, SA88-8617

v z/OS Security Server RACF マクロおよびインターフェース, SA88-8612

v z/OS Security Server RACF セキュリティー管理者のガイド, SA88-8613

参考文献 529

v z/OS Security Server RACF システム・プログラマーのガイド, SA88-8611

v z/OS Security Server RACROUTE マクロ解説書,

SA88-8621

v z/OS Support for Unicode: 変換サービスの使用,

SA88-8813

v z/OS TSO/E CLIST, SA88-8627

v z/OS TSO/E コマンド解説書, SA88-8628

v z/OS TSO/E カスタマイズ, SA88-8629

v z/OS TSO/E メッセージ, SA88-8631

v z/OS TSO/E プログラミング・ガイド,

SA88-8633

v z/OS TSO/E プログラミング・サービス,

SA88-8634

v z/OS TSO/E REXX 解説書, SA88-8635

v z/OS TSO/E ユーザーズ・ガイド, SA88-8638

v z/OS UNIX システム・サービスコマンド解説書, SA88-8641

v z/OS UNIX システム・サービスメッセージおよびコード, SA88-8645

v z/OS UNIX システム・サービス計画,

GA88-8639

v z/OS UNIX システム・サービスプログラミング: 呼び出し可能サービス解説書, SA88-8642

v z/OS UNIX システム・サービスユーザーズ・ガイド, SA88-8640


索引日本語, 数字, 英字, 特殊文字の順に配列されています。なお, 濁音と半濁音は清音と同等に扱われています。

［ア行］アカウンティング監査トレース、クラスの説明 412

トレース開始 407

停止 449

表示 221

参照： ACCTG オプションアスタリスク (*)

DB2 コマンドにおける 11

DISPLAY THREAD コマンド 208

FREE PACKAGE コマンド 295

REBIND PACKAGE コマンド 97

アスタリスク (*.*)

DISPLAY PROCEDURE コマンド 198

START PROCEDURE コマンド 402

STOP FUNCTION SPECIFIC コマンド 438

STOP PROCEDURE コマンド 444

アプリケーション・パッケージ参照：パッケージ

アプリケーション・プラン最大サイズ 5

再バインド、プランの変更 329

削除 297

バインド 63

アプリケーション・プログラムテスト 235

START コマンド 373

アプリケーション・プログラム、DSNH CLIST 処理の準備257

英文字の説明、DB2 における vii

エスケープ文字APOST オプション、DCLGEN サブコマンドの 119

QUOTE オプション、DCLGEN サブコマンドの 119

延期されたリカバリー単位、リカバリー 345

置き換え、パッケージ・バージョンの 71

オペランド、DB2 コマンド 10

［カ行］カーソル、未確定 73

拡張 MCS コンソールの DB2 サポート 22

仮想記憶アクセス方式 (VSAM)

参照： VSAM (仮想記憶アクセス方式)

監査トレース開始 407

クラスの説明 412

停止 449

表示 221

関数を永続的に使用不可にする 439

機能、情報の表示 165

許可 ID

命名規則 vii

2 次特権 3

SQL、使用される特権 3

グループ、コマンドの有効範囲 13

グループ詳細報告書、DISPLAY GROUPBUFFERPOOL コマンドの 181

グループ・バッファー・プール RECOVER ペンディング(GRECP) 状況、START DATABASE コマンドに使用による除去 381

コード、戻り参照：戻りコード

構文解析規則、DB2 コマンド 9

構文図読み方 xi

コマンド、有効範囲 13

コマンド継続文字 19

コマンド接頭部各部分、コマンドの 9

説明 9

複数のサブシステム 387

コマンド認識文字 (CRC)

参照： CRC (コマンド認識文字)

コミット・ポイント、ユーティリティーの終了 455

コメントDCLGEN サブコマンドの出力 120

DSN サブコマンド 235

コレクション、パッケージBIND PACKAGE サブコマンド 96

ID の命名規則 viii

REBIND PACKAGE サブコマンド 96

REBIND TRIGGER PACKAGE サブコマンド 337

［サ行］再始動終了したユーティリティー・ジョブ・ステップ 457

状況、DB2 リソースの 385

接続、IMS とサブシステム間の 373

CICS 接続機能 254

再バインドオプション 69

開始 325, 329


作業単位表示、未解決の 125

リセット未確定 113

IMS 113

参照：リカバリー単位削除、IMS リカバリー単位の 113

サブシステム、命名規則 x

サブシステム・パラメーターリスト 467

NPGTHRSH 470

PTASKROL 470

終了ストアード・プロシージャー 443

接続、IMS とサブシステム間の 419

データベース 421

トレース活動 449

ユーティリティー、説明 455

DB2、説明 429

IRLM

異常 299

正常 441

状況検査、IRLM 313

システム間カップリング・ファシリティー (XCF)、メンバーの状況 172

表示、DISPLAY DATABASE による 151

条件付き再始動制御レコード、再始動時の影響 387

詳細報告書、DISPLAY BUFFERPOOL コマンドの 136

処理、並列VPPSEQT オプション、ALTER BUFFERPOOL コマンドの

31

診断ダンプ、IRLM 301

ストアード・プロシージャー開始 401

状況の表示 197

停止 443

参照：ストアード・プロシージャーストリング、区切り文字

COBOL 119

SQL 119

すべてのキーワード、MODIFY irlmproc,DIAG コマンドの302

スレッド取り消し 107

表示 205

スレッドの取り消し、説明 107

接続終了 419

表示グループ・バッファー・プール 186

状況 125

接続情報 205

IRLM サブシステムの状況 315

接続 (続き)

DB2

DSN コマンドの GROUP オプション 236

RETRY オプション、DSN コマンドの 236

DSNC DISPLAY コマンド 244

接続の確立、IMS とサブシステム間の 373

接続名の命名規則 viii

宣言参照： DCLGEN サブコマンド、DSN の

相関 ID

命名規則 viii

リカバリー、スレッドの 342

走査規則、DB2 コマンド 9

［タ行］ダンプ、IRLM 診断の 301

データ共用識別、ユーティリティー・ジョブのあるメンバーの 231

遅延、診断 301

表示アーカイブ・ログ情報 130

グループの情報 171

状況、メンバーの 171

メンバーの開始 388

有効範囲、コマンドの 13

データベース開始 375

状況の表示 141

停止 421

予約名 425

データベース要求モジュール (DBRM)

参照： DBRM (データベース要求モジュール)

データ・セット、命名規則 viii

程度、並列処理の 77

統計、トレース開始 407


表示 221

統計トレース停止 449

特殊文字 vii

特権セット、処理の 3

トレースイベント 459

開始 407

停止 449

表示 221

変更、アクティブ・トレースの 321

IFCID、トレース・クラスによってアクティブ化される412

［ナ行］認識文字 9


［ハ行］バージョン、パッケージの

BIND PACKAGE サブコマンド 96


バインドオプション 69

開始 55, 63

DSNH 処理 257

参照： BIND PACKAGE

参照： BIND PLAN

参照： REBIND PACKAGE

参照： REBIND PLAN

パッケージ置き換え、バージョンの 71

再バインド 325

トリガーの再バインド 335

バインド、開始 55

ID



バッファー・プールアクティブおよび非アクティブ 29, 131

現在の状況の表示 131

属性の変更 29

並列順次スチールしきい値 (VPSEQT) 31

パフォーマンス、トレース開始 407


パフォーマンス・トレース停止 449

表示 221

パラメーター、アプリケーション・プログラムに渡す 356

表示状況グループ・バッファー・プール 177

バッファー・プール 131

DB2 データベース 141

DB2 ユーティリティー 229

情報アーカイブ・ログ 129

コミュニケーション・データベースおよびリソース限定機能 150

ストアード・プロシージャー 197

スレッド、リモート・ロケーションのある 191

制限付きオブジェクト 150

データ共用グループ 171

データ・パーティション 2 次索引 151

トレース活動 221

リソース限定機能 (管理プログラム) 203

ログ 195

論理パーティション 150

DB2 関数 165

DB2 スレッド 205

DDF 161

標識変数、DCLGEN での配列の宣言 120

表スペース、命名規則 x

表名、命名規則 x

ブートストラップ・データ・セット (BSDS)

参照： BSDS (ブートストラップ・データ・セット)

フェーズ、DSNH 処理を実行するための 257

プラン参照：アプリケーション・プラン

ブランク文字、DB2 コマンドの 10

プリコンパイラー作成、メンバーを 93

呼び出し、DSNH の 257

DSNH コマンド・オプション 271

並列処理DEGREE オプション、バインド・サブコマンドの 77

VPPSEQT オプション、ALTER BUFFERPOOL コマンドの31

法的特記事項 477

保持ロック 146

［マ行］未確定カーソル 73

未確定スレッド、リカバリー 341

無効化されたプランとパッケージ 88

命名規則、コマンド構文における変数の vii

メッセージDB2 コマンド 24

DCLGEN サブコマンド 118

DISPLAY THREAD コマンド、ACTIVE を指定 209

DISPLAY TRACE コマンド 227

DISPLAY UTILITY コマンド 230, 231

DSN コマンド、TSO の 237

DSNH コマンド 269

FLAG オプション、バインド・サブコマンドの 88

FREE PACKAGE サブコマンド 295

FREE PLAN サブコマンド 298

MODIFY irlmproc,STATUS コマンド 315

RUN サブコマンド 357

メッセージ、ID 別のDSN7106I 172

DSN9022I 24

DSN9023I 24

DSNB411I 136

DSNB412I 136

DSNB413I 136

DSNB414I 136

DSNB415I 137

DSNB420I 137

DSNB421I 137

DSNI021I 383

DSNJ315I 51

DSNJ316I 51

DSNJ317I 51

DSNJ318I 50

DSNL440I ～ DSNL449I 354

DSNL448I 353

索引 533

メッセージ、ID 別の (続き)

DSNL450I 109

DSNT392I 151

DSNT500I 152

DSNT501I 152

DSNT736I 425

DSNU100I 231

DSNU105I 231

DSNU106I 231

DSNV413I 212

DSNW133I 410

DSNX943I 200

DSNX950I 200

メンバー、コマンドの有効範囲 13

メンバー詳細報告書、DISPLAY GROUPBUFFERPOOL コマンドの 182

文字 vii

戻りコードCURRENTSERVER オプション、バインドおよび再バインド・サブコマンドの 75

DSN コマンド 237

RUN サブコマンド、DSN の 237

モニター・トレース開始 407


停止 449

表示 221

［ヤ行］ユーティリティー終了 455

状況の表示 229

ID 456

有効範囲、コマンドの 13

用語集 481

要約報告書DISPLAY BUFFERPOOL コマンド 135

DISPLAY GROUPBUFFERPOOL コマンド 180, 186

［ラ行］ライト再始動、ARM での 387

リカバリー延期されたリカバリー単位 345

未確定スレッド 341

BSDS 339

リカバリー単位、IMS の 126

リソース限定機能表示 150

リンク・エディット処理 257

列名、フィールド名としての 120

レポートグループ詳細報告書 181

詳細報告書 136

レポート (続き)

メンバー詳細報告書 182

要約報告書DISPLAY BUFFERPOOL コマンド 135

DISPLAY GROUPBUFFERPOOL コマンド 186

ロケーション名BIND PACKAGE サブコマンド 84, 96

DISPLAY LOCATION コマンド 192

REBIND PACKAGE サブコマンド 84, 96


論理パーティション、表示 150

論理ページ・リスト (LPL)

参照： LPL (論理ページ・リスト)

［数字］2 次許可 ID 3

AABEND サブコマンド、DSN の 235

ACCESS オプションSTART DATABASE コマンド 379

START DB2 コマンド 386

ACCTG オプションDISPLAY TRACE コマンド 223

MODIFY TRACE コマンド 322

START TRACE コマンド 409

STOP TRACE コマンド 450

ACQUIRE オプションBIND PLAN サブコマンド 69


REBIND PLAN サブコマンド 69

ACTION オプションBIND PACKAGE サブコマンド 70

BIND PLAN サブコマンド 70



RECOVER INDOUBT コマンド 342



ACTIVE オプションDISPLAY BUFFERPOOL コマンド 132

DISPLAY DATABASE コマンド 148


ADD オプションDCLGEN サブコマンド 118


ALLD オプション、z/OS の MODIFY irlmproc,STATUS コマンドの 314

ALLI オプション、MODIFY irlmproc,STATUS コマンド、z/OS

の 314

ALTER BUFFERPOOL コマンドオプションの説明 30

説明 29


ALTER BUFFERPOOL コマンド (続き)

例 34

ALTER BUFFERPOOL コマンドの DWQT オプション 31

ALTER BUFFERPOOL コマンドの VDWQT オプション 32

ALTER BUFFERPOOL コマンドの VPSEQT オプション 31

ALTER GROUPBUFFERPOOL コマンドオプションの説明 38

説明 37

例 41

ALTER UTILITY コマンド説明 43

例 45

APOST オプションDCLGEN サブコマンド 119


APOSTSQL オプション、DSNH コマンドの 276

ARCHIVE LOG コマンドオプションの説明 48

説明 47

例 52

ASMLIB オプション、DSNH コマンドの 263

ASMLOAD オプション、DSNH コマンドの 263

AT オプション、DCLGEN サブコマンドの 117

AT(COMMIT) オプション、STOP DATABASE コマンドの424

AUDIT オプションDISPLAY TRACE コマンド 223




AUTHID オプションDISPLAY TRACE コマンド 225



AUTOREC オプション、ALTER GROUPBUFFERPOOL コマンドの 39

BBIND PACKAGE サブコマンド、DSN のオプションの説明 69

説明 55

例 60

参照： TSO の DSN コマンドBIND PLAN サブコマンド、DSN のオプションの説明 69

説明 63

例 66

参照： TSO の DSN コマンドBLIB オプション、DSNH コマンドの 278

BMEM オプション、DSNH コマンドの 279

BnLIB オプション、DSNH コマンドの 279

BSDS (ブートストラップ・データ・セット)、リカバリー 339

BUFSIZE オプション、START TRACE コマンドの 415

CC オプション、DCLGEN サブコマンドの 118

CACHESIZE オプションBIND PLAN サブコマンド 72



CANCEL OFFLOAD オプション、ARCHIVE LOG コマンドの50

CANCEL THREAD コマンドオプションの説明 108

説明 107

例 112

CANCEL オプション、RECOVER POSTPONED コマンドの346

CASTOUT オプション、STOP DB2 コマンドの 430

CATENFM ユーティリティー、TERM コマンドの影響 457

CATMAINT ユーティリティー、TERM コマンドの影響 457

CCLINK オプション、DSNH コマンドの 263

CCLLIB オプション、DSNH コマンドの 263

CCLOAD オプション、DSNH コマンドの 263

CCMSGS オプション、DSNH コマンドの 263

CCOLIB オプション、DSNH コマンドの 263

CCPLIB オプション、DSNH コマンドの 264

CCPMSGS オプション、DSNH コマンドの 264

CCSID オプション、DSNH コマンドの 263

CCSLIB オプション、DSNH コマンドの 264

CHANGE コマンド、IMS の説明 113

例 114

CHECK DATA ユーティリティー、TERM コマンドの影響457

CHECK INDEX ユーティリティー、TERM コマンドの影響457

CHECK LOB ユーティリティー、TERM コマンドの影響 457

CHKTIME オプション、SET LOG コマンドの 364

CICS

オプション、BIND および REBIND サブコマンドの 84

コマンドDSNC 239

DSNC DISCONNECT 241

DSNC DISPLAY 243

DSNC MODIFY 249

DSNC STOP 253

DSNC STRT 255

変換ステップ、DSNH 処理における 257

DSNH コマンドのオプション 279

CICSCOB オプション、DSNH コマンドの 264

CICSLLIB オプション、DSNH コマンドの 264

CICSOPT オプション、DSNH コマンドの 264

CICSPLIB オプション、DSNH コマンドの 264

CICSPRE オプション、DSNH コマンドの 264

CICSVER オプション、DSNH コマンドの 264

CICSXLAT オプション、DSNH コマンドの 264

CLAIMERS オプション、DISPLAY DATABASE コマンドの146

索引 535

CLASS オプションDISPLAY TRACE コマンド 225

IFCID、トレース・クラスによってアクティブ化される412




CLASST オプション、ALTER GROUPBUFFERPOOL コマンドの 39

CLIB オプション、DSNH コマンドの 265

CnLIB オプション、DSNH コマンドの 265

COB2 オプション、DCLGEN サブコマンドの 118

COB2CICS オプション、DSNH コマンドの 265

COB2LIB オプション、DSNH コマンドの 265

COB2LOAD オプション、DSNH コマンドの 265

COBICOMP オプション、DSNH コマンドの 265

COBILINK オプション、DSNH コマンドの 265

COBIPLNK オプション、DSNH コマンドの 265

COBIPMSG オプション、DSNH コマンドの 265

COBLIB オプション、DSNH コマンドの 265

COBLOAD オプション、DSNH コマンドの 265

COBOL オプション、DCLGEN サブコマンドの 118

COBSOM オプション、DSNH コマンドの 265

COLSUFFIX オプション、DCLGEN サブコマンドの 120

comma オプション、DSNH コマンドの 268

COMMENT オプションDISPLAY TRACE コマンド 224




COMP オプション、TRACE CT コマンドの 462

COMPILE オプション、DSNH コマンドの 266

CONNLIST オプション、DISPLAY GROUPBUFFERPOOL コマンドの 179

CONTROL オプション、DSNH コマンドの 266

COPTION オプション、DSNH コマンドの 266

COPY オプションBIND PACKAGE サブコマンド 72


COPY ユーティリティー、TERM コマンドの影響 457

COPYVER オプションBIND PACKAGE サブコマンド 72


CORRELATION オプション、START TRACE コマンドの 415

COUNT オプション、SET ARCHIVE コマンドの 360

CP オプション、RUN サブコマンドの 356

CPP オプション、DCLGEN サブコマンドの 118

CPPCLASS オプション、DSNH コマンドの 266

CPPCLLIB オプション、DSNH コマンドの 266

CPPCSLIB オプション、DSNH コマンドの 266

CPPLINK オプション、DSNH コマンドの 266

CPPLLIB オプション、DSNH コマンドの 266

CPPPMSGS オプション、DSNH コマンドの 267

CPPSLIB オプション、DSNH コマンドの 267

CPPUTIL オプション、DSNH コマンドの 267

CPU オプション、START TRACE コマンドの 416

CRC (コマンド認識文字)、説明 9

CURRENTDATA オプションBIND PACKAGE サブコマンド 73


DSNH コマンド 279, 282




CURRENTSERVER オプションBIND PLAN サブコマンド 74



CYLINDER オプション、DSNH コマンドの 275

DDATE


DB2 コマンド完了メッセージ 24

コマンドALTER BUFFERPOOL 29

ALTER GROUPBUFFERPOOL 37

ALTER UTILITY 43

ARCHIVE LOG 47

CANCEL THREAD 107

DISPLAY ARCHIVE 129

DISPLAY BUFFERPOOL 131

DISPLAY DATABASE 141

DISPLAY DDF 161

DISPLAY GROUP 171

DISPLAY GROUPBUFFERPOOL 177

DISPLAY LOCATION 191

DISPLAY LOG 195

DISPLAY PROCEDURE 197

DISPLAY RLIMIT 203

DISPLAY THREAD 205

DISPLAY TRACE 221

DISPLAY UTILITY 229

MODIFY TRACE 321

RECOVER BSDS 339

RECOVER INDOUBT 341, 344

RECOVER POSTPONED 345

RESET INDOUBT 351

SET SYSPARM 367

START DATABASE 375

START DB2 385

START DDF 389

START FUNCTION SPECIFIC 391

START PROCEDURE 401

START RLIMIT 405

START TRACE 407

STOP DATABASE 421

STOP DB2 429

STOP DDF 433

STOP FUNCTION SPECIFIC 437


DB2 コマンド (続き)

コマンド (続き)

STOP PROCEDURE 443

STOP RLIMIT 447

STOP TRACE 449

TERM UTILITY 455

コマンド名 10

説明 10

入力、サポートされる環境からの 22

分離文字 10

有効範囲 13

DISPLAY FUNCTION SPECIFIC 165

DB2 プリコンパイラー 10

DBM1 オプション、START DB2 コマンドの 387

DBPROTOCOL オプションBIND PACKAGE サブコマンド 75





DBRM (データベース要求モジュール)

最大数、プランにおける 5


DBRMLIB オプション、DSNH コマンドの 267

DCLGEN サブコマンド、DSN のオプションの説明 116

形成、フィールド名の 120

説明 115

宣言、標識変数配列の 120

例 122

参照： TSO の DSN コマンドDCLGEN (宣言生成機能)

参照： DCLGEN サブコマンド、DSN のDDF (分散データ機能)、表示 161

DEADLINE オプション、ALTER UTILITY コマンドの 44

DECARTH オプション、DSNH コマンドの 268

DECIMAL


DEFAULT オプション、SET ARCHIVE コマンドの 361

DEFER

BIND PLAN サブコマンドのオプション 76

DEFER オプションBIND PACKAGE サブコマンド 76





DEGREE オプションBIND PACKAGE サブコマンド 77





DELAY

キーワード、MODIFY irlmproc,DIAG コマンドの 302

DELAY オプション、ALTER UTILITY コマンドの 45

DELIMIT オプション、DSNH コマンドの 268

DEST オプションDISPLAY TRACE コマンド 224



DESTINATION オプション、DSNC MODIFY コマンドの 249

DETAIL オプションDISPLAY BUFFERPOOL コマンド 133

DISPLAY GROUP コマンド 172

DISPLAY LOCATION コマンド 193



DIAG キーワード、MODIFY irlmproc,DIAG コマンドの 302

DIAGNOSE ユーティリティー、TERM コマンドの影響 457

DISABLE オプションBIND PACKAGE サブコマンド 83





DISCONNECT オプションBIND PLAN サブコマンド 78



DISPLAY ARCHIVE コマンド 129

DISPLAY BUFFERPOOL コマンドオプションの説明 132

出力 135

説明 131

DISPLAY DATABASE コマンドオプションの説明 144

説明 141

例 153

DISPLAY DATABASE コマンドの ADVISORY オプション149

DISPLAY DATABASE コマンドの AFTER オプション 147

DISPLAY DATABASE コマンドの LIMIT オプション 147

DISPLAY DATABASE コマンドの ONLY オプション 146

DISPLAY DATABASE コマンドの OVERVIEW オプション147

DISPLAY DATABASE コマンドの RESTRICT オプション148

DISPLAY DATABASE コマンドの WEPR オプション 146

DISPLAY DDF コマンドオプションの説明 162

出力 162

説明 161

例 162

DISPLAY FUNCTION SPECIFIC コマンド出力 167

説明 165

例 168

DISPLAY FUNCTION SPECIFIC コマンドのschema.specific-function-name オプション 166

DISPLAY GROUP コマンド説明 171

索引 537

DISPLAY GROUP コマンド (続き)

例 174

IRLM 情報 173

DISPLAY GROUPBUFFERPOOL コマンドオプションの説明 178

出力 181

説明 177

要約報告書の例 186

DISPLAY LOCATION コマンドオプションの説明 192

説明 191

例 193

DISPLAY LOG コマンド説明 195

例 196

DISPLAY NET コマンド、VTAM の 110

DISPLAY PROCEDURE コマンドオプションの説明 198

出力 199

説明 197

例 200

DISPLAY RLIMIT コマンド 203

DISPLAY THREAD コマンドオプションの説明 208

出力 212

説明 205

例 215

DISPLAY THREAD コマンドの INACTIVE オプション 209

DISPLAY THREAD コマンドの INDOUBT オプション 209

DISPLAY THREAD コマンドの POSTPONED オプション209

DISPLAY THREAD コマンドの RRSURID オプション 211

DISPLAY TRACE コマンドオプションの説明 223

出力 226

説明 221

例 226

DISPLAY UTILITY コマンドオプションの説明 229

出力 231

説明 229

例 233

DISPLAY コマンド、IMS のオプションの説明 125

説明 125

例 127

DIST オプション、START DB2 コマンドの 387

DISTRIBUTED オプション、START TRACE コマンドの 416

DLIBATCH オプションBIND および REBIND サブコマンド 84


DSN コマンド、TSO のオプションの説明 236

構文解析、サブコマンドの 19

サブコマンドABEND 235

DSN コマンド、TSO の (続き)

サブコマンド (続き)

BIND PACKAGE 55

BIND PLAN 63

DCLGEN 115

END 291

FREE PACKAGE 293

FREE PLAN 297

REBIND PACKAGE 325

REBIND PLAN 329

REBIND TRIGGER PACKAGE 335

RUN 355

SPUFI 369

省略形 19

説明 235

戻りコード 237

例 237

DSN コマンドの CONNECT オプション 266

DSN コマンドの GROUP オプション 236

DSN の REBIND PACKAGE サブコマンドオプションの説明 69

説明 325

例 328

参照： TSO の DSN コマンドDSN の REBIND PLAN サブコマンドオプションの説明 69

説明 329

例 332

参照： TSO の DSN コマンドDSNC DISCONNECT コマンド、CICS の説明 241

例 242

DSNC DISPLAY コマンド、CICS のオプションの説明 243

出力 245

説明 243

例 246

DSNC MODIFY コマンド、CICS のオプションの説明 249

説明 249

例 250

DSNC STOP コマンド、CICS のオプションの説明 253

説明 253

例 254

DSNC STRT コマンド、CICS のオプションの説明 255

説明 255

例 256

DSNC コマンド、CICS の 239

DSNDB01 データベース、開始のために必要な権限 376

DSNDB06 データベース、開始のために必要な権限 376

DSNH コマンド、TSO のオプションの説明 259

説明 257

データ・セット名 262


DSNH コマンド、TSO の (続き)

例 287

DSNH コマンドの BDBRMLIB オプション 280

DSNH コマンドの BDMEM オプション 278

DSNH 処理の実行 257

DSNHDECP

リスト、パラメーターの 467

DSNZPARM

オプション、START DB2 コマンドの 386

リスト、パラメーターの 467

DUMP オプションCANCEL THREAD コマンド 108

MODIFY irlmproc,ABEND コマンド 299

DYNAMICRULES オプションBIND PACKAGE サブコマンド 78





EENABLE オプション






ENCODING オプションBIND PACKAGE サブコマンド 85




END サブコマンド、DSN の説明 291

例 291

ENTRY オプション、DSNH コマンドの 268

EXPLAIN オプションBIND PACKAGE サブコマンド 86






FFLAG オプション




FREE PACKAGE サブコマンド 295

FREE PLAN サブコマンド 298



FLAG オプション (続き)


FORCE オプションDSNC STOP コマンド 253

RESET INDOUBT コマンド 352

START DATABASE コマンド 380

STOP DB2 コマンド 430

STOP DDF コマンド 434

FORTLIB オプション、DSNH コマンドの 269

FORTLOAD オプション、DSNH コマンドの 269

FREE PACKAGE サブコマンド、DSN のオプションの説明 294

説明 293

例 296

参照： TSO の DSN コマンドFREE PLAN サブコマンド、DSN のオプションの説明 298

説明 297

例 298

参照： TSO の DSN コマンド

GGBPCACHE オプション、ALTER GROUPBUFFERPOOL コマンドの 38

GBPCHKPT オプション、ALTER GROUPBUFFERPOOL コマンドの 40

GBPOOLT オプション、ALTER GROUPBUFFERPOOL コマンドの 40

GDETAIL オプション、DISPLAY GROUPBUFFERPOOL コマンドの 179

GLOBAL オプション、START irlmproc コマンドの 398

GRAPHIC オプション、DSNH コマンドの 269

GTF オプションDISPLAY TRACE コマンド 224



HHOST オプション、DSNH コマンドの 269

IIBMCOB オプション、DCLGEN サブコマンドの 118

ID オプションRECOVER INDOUBT コマンド 342

START RLIMIT コマンド 406

IFCID オプションMODIFY TRACE コマンド 323


IFCID (計測機能コンポーネント ID)、トレース・クラス別ID 412

IMMEDWRITE オプションBIND PACKAGE サブコマンド 89

索引 539

IMMEDWRITE オプション (続き)




IMS

機能、イベント・トレース 459

コマンドCHANGE 113

DISPLAY 125

SSR 371

START 373

STOP 419

TRACE 459

IMS の SSR コマンド、説明 371

IMSBMP オプションBIND および REBIND サブコマンド 84


IMSMPP オプションBIND および REBIND サブコマンド 84


IMSPRE オプション、DSNH コマンドの 269

INCLUDE ステートメント、DCLGEN サブコマンド出力の120

INDVAR オプション、DCLGEN サブコマンドの 120

INPUT オプション、DSNH コマンドの 269

INTERVAL オプション、DISPLAY BUFFERPOOL コマンドの133

IPADDR オプションDISPLAY LOCATION コマンド 192


IRLM (内部リソース・ロック・マネージャー)

開始診断トレース 461

IRLM 構成要素 395

概説 25

コマンドMODIFY irlmproc,ABEND 299

MODIFY irlmproc,DIAG 301

MODIFY irlmproc,PURGE オプション 305

MODIFY irlmproc,SET オプション 307

MODIFY irlmproc,STATUS オプション 313

START irlmproc 395

STOP irlmproc 441

TRACE CT 461

再始動CSA 値への影響 309

修正、診断トレースの 461

終了異常 299

正常 441

状況検査 307

状況、検査 313

診断ダンプ 301

遅延、診断 301

IRLM (内部リソース・ロック・マネージャー) (続き)

停止診断トレース 461

正常 441

登録抹消 299

トレース・バッファー、数の設定 307

ロック・リリース 305

CSA

最大の設定 307

DISPLAY GROUP コマンド出力 173

IRLM の登録抹消 300

IRLMGRP オプション、START irlmproc コマンドの 396

IRLMID オプション、START irlmproc コマンドの 396

IRLMNM オプション、START irlmproc コマンドの 397

ISOLATION

BIND PLAN サブコマンドのオプション説明 90

ISOLATION オプションBIND PACKAGE サブコマンド 90





I/O 処理、並列、バインド・サブコマンドの DEGREE オプション 77

KKEEPDYNAMIC オプション






LLABEL オプション、DCLGEN サブコマンドの 119

LANGUAGE オプション、DCLGEN サブコマンドの 118

LEAVE オプション、DSNH コマンドの 277

LIBRARY オプションBIND PACKAGE サブコマンド 93




LIGHT オプション、START DB2 コマンドの 386

LINECOUNT オプション、DSNH コマンドの 269

LINK オプション、DSNH コマンドの 270

LIST オプション、DISPLAY BUFFERPOOL コマンドの 133

LLIB オプション、DSNH コマンドの 270

LnLIB オプション、DSNH コマンドの 270

LOAD オプションDSNH コマンド 270

SET SYSPARM コマンド 368

LOAD ユーティリティー、TERM コマンドの影響 457


LOCAL オプション、START irlmproc コマンドの 398

LOCATION オプションDISPLAY THREAD コマンド 210





LOCKS オプション、DISPLAY DATABASE コマンドの 146

LOCKTABL オプション、START irlmproc コマンドの 397

LOG オプション、TRACE コマンドの 460

LOGLOAD オプション、SET LOG コマンドの 364

LONGLOG オプション、ALTER UTILITY オプションの 45

LOPTION オプション、DSNH コマンドの 270

LPL (論理ページ・リスト)

ページのリカバリー使用、START DATABASE コマンドの 381

DISPLAY DATABASE コマンドのオプション 146

LSTATS オプション、DISPLAY BUFFERPOOL コマンドの133

LTE オプション、START irlmproc コマンドの 397

LTE オプション、z/OS の MODIFY irlmproc,SET コマンド308

LUNAME オプションDISPLAY LOCATION コマンド 192


LUWID オプションDISPLAY THREAD コマンド 210

RECOVER INDOUBT コマンド 343


MMACRO オプション、DSNH コマンドの 270

MAINT オプション、START DB2 コマンドの 386

MAINT オプション、z/OS の MODIFY irlmproc,STATUS コマンドの 315

MAXRO オプション、ALTER UTILITY コマンドの 45

MAXUSRS オプション、START irlmproc コマンドの 398

MCS コンソール、コマンドの有効範囲 13

MDETAIL オプション、DISPLAY GROUPBUFFERPOOL コマンドの 179

MEMBER オプションBIND PACKAGE サブコマンド 93


DISPLAY UTILITY コマンド 230

MERGECOPY ユーティリティー、TERM コマンドの影響 457

MODE オプションARCHIVE LOG コマンド 48



MODIFY irlmproc,ABEND コマンド、z/OS の説明 299

例 300

MODIFY irlmproc,DIAG コマンド、z/OS の説明 301

例 303

MODIFY irlmproc,PURGE コマンド、z/OS の説明 305

例 306

MODIFY irlmproc,SET コマンド、z/OS のオプションの説明 305, 308

説明 307

例 310

MODIFY irlmproc,STATUS コマンド、z/OS のオプションの説明 314

説明 313

例 315

MODIFY RECOVERY ユーティリティー、TERM コマンドの影響 457

MODIFY STATISTICS ユーティリティー、TERM コマンドの影響 457

MODIFY TRACE コマンド説明 321

例 323

MONITOR オプションDISPLAY TRACE コマンド 223




MSTR オプション、START DB2 コマンドの 387

NNAMES オプション、DCLGEN サブコマンドの 118

NEWFUN オプション、DSNH コマンドの 270

NID (network ID) オプション、RECOVER INDOUBT コマンドの 343

NO LIMIT オプション、SET ARCHIVE コマンドの 360

NO オプションSTART DB2 コマンド 386

START irlmproc コマンド 399

NOBACKOUT オプション、CANCEL THREAD コマンドの108

NODEFER オプションBIND PACKAGE サブコマンド 76





NODUMP オプション、MODIFY irlmproc,ABEND コマンドの300

NOFOR オプション、DSNH コマンドの 271

NONE キーワード、MODIFY irlmproc,DIAG コマンドの 302

NOWRAP オプション、TRACE CT コマンドの 462

OOASN オプション

CHANGE コマンド 114

DISPLAY コマンド 126

索引 541

OP オプションSTART TRACE コマンド 410


OPTHINT オプションBIND PACKAGE サブコマンド 94





OPTIONS オプションBIND PACKAGE サブコマンド 95


OUTNAME オプション、DSNH コマンドの 271

OWNER オプションBIND PACKAGE サブコマンド 95






PP irlmproc コマンド。参照： STOP irlmproc コマンド、z/OS の

PACKAGE オプション、DSNH コマンドの 284

PACTION オプション、DSNH コマンドの 282

PARM オプション、START DB2 コマンドの 386

PARMS オプションDSNH コマンド 271


PART オプションDISPLAY DATABASE コマンド 147


STOP DATABASE コマンド 424

partial-location name、DISPLAY LOCATION コマンド 192

PASS オプション、DSNH コマンドの 271

PATH オプションBIND PACKAGE サブコマンド 98





PATHDEFAULT オプションREBIND PACKAGE サブコマンド 99


PBIND オプション、DSNH コマンドの 282

PCICS オプション、DSNH コマンドの 282

PCLOAD オプション、DSNH コマンドの 271

PDBPROTOCOL オプション、DSNH コマンドの 282

PDBRMLIB オプション、DSNH コマンドの 283

PDEFER オプション、DSNH コマンドの 283

PDEGREE オプション、DSNH コマンドの 283

PDISABLE オプション、DSNH コマンドの 283

PDLIBATCH オプション、DSNH コマンドの 283

PDMEM オプション、DSNH コマンドの 283

PDYNAMICRULES オプション、DSNH コマンドの 283

PENABLE オプション、DSNH コマンドの 284

PERFM オプションDISPLAY TRACE コマンド 223




PFLAG オプション、DSNH コマンドの 284

PGPROT オプション、START irlmproc コマンドの 398

PGSTEAL オプション、ALTER BUFFERPOOL コマンドの 32

PIMSBMP オプション、DSNH コマンドの 284

PIMSMPP オプション、DSNH コマンドの 284

PISOLATION オプション、DSNH コマンドの 284

PKEEPDYNAMIC オプション、DSNH コマンドの 284

PKLIST オプションBIND PLAN サブコマンド 99



PLAN


PLAN オプションBIND PLAN サブコマンド 101


DSNC DISPLAY コマンド 243






plan-name の命名規則 x

PLI オプション、DCLGEN サブコマンドの 118

PLI2LIB オプション、DSNH コマンド 272

PLIB オプション、DSNH コマンドの 272

PLILIB オプション、DSNH コマンドの 272

PLILOAD オプション、DSNH コマンドの 272

PLIPLNK オプション、DSNH コマンドの 272

PLIPMSG オプション、DSNH コマンドの 272

PLOCK キーワード、MODIFY irlmproc,DIAG コマンドの 302

PL/I アプリケーション・プログラム、DSNH 用のマクロ処理ステップ 257

PnLIB オプション、DSNH コマンドの 272

PNODEFER オプション、DSNH コマンドの 284

POPTHINT オプション、DSNH コマンドの 284

POPTION オプション、DSNH コマンドの 272

POWNER オプション、DSNH コマンドの 284

PPATH オプション、DSNH コマンドの 285

PQUALIFIER オプション、DSNH コマンドの 285

PRECOMP オプション、DSNH コマンドの 272

PRELEASE オプション、DSNH コマンドの 285

PRELINK オプション、DSNH コマンドの 273

PREOPT オプション、DSNH コマンドの 285

PRINT オプション、DSNH コマンドの 273

PROGRAM オプション、RUN サブコマンドの 356

PSECSPAC オプション、DSNH コマンドの 273

PSPACE オプション、DSNH コマンドの 274

PVALIDATE オプション、DSNH コマンドの 285


PVT オプション、z/OS の MODIFY irlmproc,SET コマンド308

QQUALIFIER オプション






qualifier-name の命名規則 x

QUIESCE オプションDSNC STOP コマンド 253



QUIESCE ユーティリティー、TERM コマンドの影響 457

QUOTE オプションDCLGEN サブコマンド 119


RRATIO オプション、ALTER GROUPBUFFERPOOL コマンドの 39

RCTERM オプション、DSNH コマンドの 274

REBIND TRIGGER PACKAGE サブコマンド、DSN のオプションの説明 69

説明 335

例 338

REBUILD INDEX ユーティリティー、TERM コマンドの影響457

RECOVER BSDS コマンド説明 339

例 340

RECOVER INDOUBT コマンドオプションの説明 342

説明 341

例 344

RECOVER POSTPONED コマンド説明 345

例 346

RECOVER ユーティリティー、TERM コマンドの影響 457

RELEASE オプションBIND PACKAGE サブコマンド 102

BIND PLAN サブコマンド説明 102





RELOAD オプション、SET SYSPARM コマンドの 368

REMOTE オプション、DSNH コマンドの 285

REOPT オプションBIND PACKAGE サブコマンド 103

REOPT オプション (続き)





REORG INDEX ユーティリティー、TERM コマンドの影響457

REORG TABLESPACE ユーティリティー、TERM コマンドの影響 457

REPAIR ユーティリティー、TERM コマンドの影響 458

REPLACE オプションDCLGEN サブコマンド 118


REPLVER オプション影響 71



REPORT ユーティリティー、TERM コマンドの影響 458

RES オプション、STOP TRACE コマンドの 451

RESET GENERICLU コマンドオプションの説明 350

説明 349

例 350

RESET INDOUBT コマンドオプションの説明 352

説明 351

RESET オプション、CHANGE コマンドの 114

RESUME オプション、SET LOG コマンドの 365

RETAIN オプションBIND PLAN サブコマンド 71


RETRY オプション、DSN コマンドの 236

RO オプション、START DATABASE コマンドの 379

RUN

DSN のサブコマンドオプションの説明 356

説明 355

戻りコード 237

例 358

RUN オプションDSNH コマンド・パラメーター 274

RUNIN オプション、DSNH コマンドの 274

RUNOUT オプション、DSNH コマンドの 275

RUNSTATS ユーティリティー、TERM コマンドの影響 458

RW オプション、START DATABASE コマンドの 379

Sschema.partial-name オプション

DISPLAY FUNCTION SPECIFIC コマンド 166

START FUNCTION SPECIFIC コマンド 392


schema.specific-function-name オプションDISPLAY FUNCTION SPECIFIC コマンド 166



索引 543

SCOPE オプションARCHIVE LOG コマンド 50

DISPLAY FUNCTION SPECIFIC コマンド 166










SET ARCHIVE コマンドオプションの説明 360

説明 359

例 361

SET LOG コマンドオプションの説明 364

説明 363

例 366

SET SYSPARM コマンドオプションの説明 368

説明 367

例 368

SMF オプションDISPLAY TRACE コマンド 224



SOMDLLI オプション、DSNH コマンドの 275

SOURCE オプション、DSNH コマンドの 275

SPACENAM オプションDISPLAY DATABASE コマンド 144


STOP DATABASE コマンド 423

SPACEUN オプション、DSNH コマンドの 275

SPUFI サブコマンド、DSN の参照： TSO の DSN コマンド

SPUFI、説明 369

SQL ID (SQL 許可 ID)

参照：許可 ID、SQL

SQL オプション、DSNH コマンドの 275

SQLDELIM オプション、DSNH コマンドの 276

SQLERROR オプションBIND PACKAGE サブコマンド 104


SQLFLAG オプション、DSNH コマンドの 276

SQLRULES オプションBIND PLAN サブコマンド 104


SQLRULES オプション、DSNH コマンドの 282

SRC (サブシステム認識文字)

参照：コマンド接頭部SRV オプション




START DATABASE コマンドオプションの説明 377

グループ・バッファー・プールにおけるオブジェクトのリカバリー 381

説明 375

リカバリー、論理ページ・リストのページの 381

例 383

START DB2 コマンドオプションの説明 386

説明 385

例 388

START DDF コマンド 389

START FUNCTION SPECIFIC コマンドオプションの説明 392

説明 391

例 393

START irlmproc コマンド、z/OS のオプションの説明 396

説明 395

例 399

START irlmproc コマンドの DEADLOK オプション 396

START irlmproc コマンドの MAXCSA オプション 398

START irlmproc コマンドの NODISCON オプション 398

START irlmproc コマンドの PC オプション 398

START PROCEDURE コマンドオプションの説明 402

説明 401

例 403

START RLIMIT コマンド説明 405

例 406

START TRACE コマンドオプションの説明 409

説明 407

例 417

START コマンド、IMS の 373

STARTUP オプション、SET SYSPARM コマンドの 368

STAT オプションDISPLAY TRACE コマンド 223




STATISTICS オプション、DSNC DISPLAY コマンドの 244

STDSQL オプション、DSNH コマンドの 276

STOP DATABASE コマンドオプションの説明 423

説明 421

例 427

STOP DB2 コマンド説明 429

例 431

STOP DDF コマンド説明 433

例 435

STOP FUNCTION SPECIFIC コマンドオプションの説明 438


STOP FUNCTION SPECIFIC コマンド (続き)

説明 437

の制限 439

例 439

STOP FUNCTION SPECIFIC の QUEUE オプション 438, 439

STOP FUNCTION SPECIFIC の REJECT オプション 439

STOP irlmproc コマンド、z/OS の 441

STOP PROCEDURE コマンドオプションの説明 444

説明 443

例 446

STOP RLIMIT コマンド 447

STOP TRACE コマンドオプションの説明 450

説明 449

例 454

STOP コマンド、IMS の 419

STOR オプション、MODIFY irlmproc,STATUS コマンド、z/OS

の 315

STOSPACE ユーティリティー、TERM コマンドの影響 458

string オプションの命名規則 x

STRUCTURE オプション、DCLGEN サブコマンドの 118

SUB オプション、TRACE CT コマンドの 462

SUBS オプション、TRACE コマンドの 460

SUBSYS オプションCHANGE コマンド 113

DISPLAY コマンド 125

START コマンド 373

STOP コマンド 419

SUFFIX オプション、DSNH コマンドの 276

SUSPEND オプションSET LOG コマンド 364


SYSTEM オプションDSN コマンド 236


TTABLE オプション、DCLGEN サブコマンドの 116

TDATA オプション、START TRACE コマンドの 415

TERM UTILITY コマンド説明 455

例 458

TERM オプション、DSNH コマンドの 277

TEST オプション、DSN コマンドの 236

TIME オプションARCHIVE LOG コマンド 49


SET ARCHIVE コマンド 360

TIMEOUT オプション、z/OS の MODIFY irlmproc,SET コマンドの 309

TNO オプションDISPLAY TRACE コマンド 225


TRACE CT コマンド、z/OS のオプションの説明 462

説明 461

例 463

TRACE オプションMODIFY irlmproc,SET コマンド、z/OS の 309

MODIFY irlmproc,STATUS コマンド、z/OS の 315



TRACE コマンド、IMS の説明 459

例 460

TRACK オプション、DSNH コマンドの 275

TRANSACTION オプションDSNC DISPLAY コマンド 244

DSNC MODIFY コマンド 250

TSO CLIST、DSNH の 257

TSO オプション、DSNH コマンドの 274

TYPE オプションDISPLAY GROUPBUFFERPOOL コマンド 178


UUNLOAD ユーティリティー、TERM コマンドの影響 458

USE オプション、DISPLAY DATABASE コマンドの 145

UT オプション、START DATABASE コマンドの 380

utility-id の命名規則 x

VVALIDATE オプション






VERSION オプション、DSNH コマンドの 277

version-id の命名規則 x

VPPSEQT オプション、ALTER BUFFERPOOL コマンドの 31

VPSIZE オプション、ALTER BUFFERPOOL コマンドの 30

VPXPSEQT オプション、ALTER BUFFERPOOL コマンドの31

VSAM (仮想記憶域アクセス方式) パスワード、DCLGEN サブコマンド 117

VTAM (仮想記憶通信アクセス方式)、DISPLAY NET コマンド110

WWAIT オプション、ARCHIVE LOG コマンドの 49

WORKUNIT オプション、DSNH コマンドの 277

WRAP オプション、TRACE CT コマンドの 462

WSECPAC オプション、DSNH コマンドの 277

WSPACE オプション、DSNH コマンドの 277

索引 545

WTRSTART オプション、TRACE CT コマンドの 462

WTRSTOP オプション、TRACE CT コマンドの 462

XXCF (システム間カップリング・ファシリティー)、メンバーの状況 172

XLIB オプション、DSNH コマンドの 277

XREF オプション、DSNH コマンドの 277

YYES オプション

START DB2 コマンド 386


ZZPARM

参照：サブシステム・パラメーターz/OS コマンド

MODIFY irlmproc,ABEND 299

MODIFY irlmproc,DIAG 301

MODIFY irlmproc,PURGE 305

MODIFY irlmproc,SET 307

MODIFY irlmproc,STATUS 313

START irlmproc 395

STOP irlmproc 441

TRACE CT 461

z/OS の MODIFY irlmproc,SET コマンドの MLT オプション308

［特殊文字］″ (引用符)、DB2 コマンドにおける 11

’ (アポストロフィ)、DB2 コマンドにおける 10

( ) (括弧)、DB2 コマンドにおける 11

* (アスタリスク)

DB2 コマンドにおける 11


FREE PACKAGE コマンド 295

REBIND PACKAGE コマンド 97

*.* (アスタリスク)





, (コンマ)、DB2 コマンドにおける 10

: (コロン)、DB2 コマンド 11

= (等号)、DB2 コマンドにおける 11


��

プログラム番号: 5625-DB2

Printed in Japan

SC88-9809-03

2 db2 universal database for z/os - 無料ホームページ …¬¬77 章-stop ddf (db2) 433 第78...

Documents