DSN1PRNT

DSN1PRNT スタンドアロン・ユーティリティーを使用して、Db2® VSAM データ・セットを印刷できます。 これらのデータ・セットの内容は、表スペースまたは索引スペース、イメージ・コピー・データ・セット、Db2 表スペースまたは索引スペースを含む順次データ・セットのいずれかです。

Db2 VSAM データ・セット は、非パーティション化表スペースまたは索引の 1 つのピースか、パーティション化表スペースまたは索引の 1 つの パーティションまたは、FlashCopy® イメージ・データ・セットです。入力は、単一の z/OS® 順次データ・セット または VSAM データ・セットでなければなりません。入力データ・セットの連結はサポートされません。

DSN1PRNT を使用すると、Db2 データ・セットおよびデータベースの 16 進ダンプを印刷することができます。 FORMAT オプションを指定すると、DSN1PRNT は、フォーマット設定ができないようなエラーのないページ のデータおよび索引のフォーマット設定を行います。DSN1PRNT は、そのようなエラーを検出すると、 そのページの直前にエラー・メッセージを印刷し、フォーマット設定せずにそのページをダンプします。 フォーマット設定はその次のページから再開されます。

圧縮レコード (ディクショナリー・ページの圧縮データを含む) は、圧縮形式で印刷されます。

DSN1PRNT は、表スペースまたは索引の内容を把握する必要があるときに 特に役立ちます。DSN1PRNT はイメージ・コピー・データ・セット、表スペースおよび索引に対して 実行することができます。DSN1PRNT は、FULLCOPY オプションが指定されていると、入力として索引イメージ・コピーを受け入れます。

並行コピーには DSN1PRNT を実行できません。

DSN1PRNT は、LOB キーワードが使用され、INLCOPY キーワードが省略されている場合は、LOB 表スペース と互換性があります。

DSN1PRNT は、暗号化されたデータの暗号化解除は行いません。このユーティリティーはデータを 現状のまま表示します。

出力

このユーティリティーの用途の 1 つは、システム問題の判別と修正の手助けをすることです。 Db2 を診断する際、このユーティリティーの出力を解釈するために ライセンス資料を参照しなければならない場合があります。

環境

z/OS ジョブとして DSN1PRNT を実行してください。

DSN1PRNT は、Db2 サブシステムが作動可能でない場合でも実行することができ ます。Db2 サブシステムが作動可能なときに DSN1PRNT を使用することにした場合は、 印刷する Db2 データ・セットが現在 Db2 に割り振られていないことを確認してください。

現在 Db2 にデータ・セットが割り振られていない ことを確実にするには、印刷する表スペースおよび索引を指定して Db2 STOP DATABASE コマンドを発行します。

必要な許可

特別な許可は不要です。ただし、RACF® 保護 されているデータ・セットがある場合は、ジョブの許可 ID は RACF 権限を 持っている必要があります。

必要なデータ・セット

DSN1PRNT は、以下の DD ステートメントを 使用します。

SYSPRINT
DSN1PRNT からの出力メッセージとすべての 16 進ダンプ出力が入る データ・セットを定義します。
SYSUT1
入力データ・セットを定義します。 入力データ・セットは、順次データ・セットでも VSAM データ・セットでも構いません。

このデータ・セットを Db2 が使用しないようにするために、必ず、後処理を OLD(DISP=OLD) と指定 する必要があります。Db2 STOP DATABASE コマンドが機能しない環境の場合のみ、このデータ・セットの後処理 を SHR(DISP=SHR) と指定します。

要求された操作は、指定されたデータ・セットに対してのみ行われます。入力データ・セットが、2 GB より大きい 非パーティション化表スペースまたは索引スペースに属しているか、パーティション化表スペースまたは索引スペースである場合、 正しいデータ・セットを指定するよう注意する必要があります。 例えば、4 つのパーティションを持つ表スペースの 2 番目のパーティションのページ範囲を印刷する場合 は、NUMPARTS(4)、および表スペースを構成する VSAM データ・セット・グループのデータ・セット のデータ・セット名を指定します。 次の指定は、そのデータ・セット名を示しています。

DSN=...A002

FASTSWITCH 動作を指定してオンライン REORG ユーティリティーを 実行する場合は、DSN1PRNT ユーティリティーを実行する前に、データ・セット名を 検証してください。FASTSWITCH を使用する場合、データ・セット名の 5 番目のレベルの修飾子 は I0001 と J0001 の間を交互に替わります。表スペース がクローンを持っている場合、第 5 レベル修飾子には I0002 または J0002 も あります。DSN1PRNT ユーティリティーの実行を成功させるためには、データ・セット名の 5 番目のレベルの修飾子を正しく指定する必要があります。 正しい第 5 レベル修飾子を判別するには、各データ・パーティションについて SYSIBM.SYSTABLEPART の IPREFIX 列を照会するか、 各索引パーティションについて SYSIBM.SYSINDEXPART の IPREFIX 列を照会します。 このオブジェクトがパーティション化されていない場合は、照会で PARTITION 列の値にゼロを使用してください。