DUMP コマンド

このセクションでは、トラブルシューティング・コマンド DUMP の概要を示します。

使用法

DUMP コマンドは、診断に使用されるツールです。これは、入力データ・セットの印刷出力をダンプ形式で提供します。入力データ・セット内のすべてのレコード、選択した範囲のレコード、または特定のレコード・タイプをダンプすることができます。

使用上の注意

DUMP コマンドは、レコード・ダンプ・モジュールのオプションを定義します。
ダンプは、16 進ダンプ・フォーマットで SYSPRINT に書き込まれます。
DUMP および TAPECOPY コマンドのサンプル JCL は、DUMP および TAPECOPY コマンドのサンプル JCL を示しています。

構文

サブコマンド・オプション

ダンプ名

ダンプに印刷されるユーザー定義名。このフィールドを省略すると、レコードは DUMP0001という名前で識別されます。

指定された名前が、 OMEGAMON ® for DB2® PE コマンドのキーワードまたは省略形と同じでないことを確認してください。

EXEC

入力データ・セットの DD 名として INPUTDD を指定します。 INPUTDD は、このオプションに有効な唯一の DD 名であり、指定する必要があります。

OFFSET

レコード内のレコード・コードのオフセット。レコード・コードは、位置 offset-plus-1の 1 バイト・フィールドです。例えば、OFFSET (4) は、レコードの 5 番目のバイトにレコード・コードを定義します。オフセットは、レコードの実際の長さより小さい数値でなければなりません。最大値は 999 999 999 です。デフォルトは 4 です。

CODES

処理されるレコードのコード値。各コードは 2 桁の 16 進数です。以下のいずれかを指定できます。

値のリスト (例: '01,02,03' )
値の範囲 (例: '01-03,05-07' )

各項目はコンマで区切る必要があります。複数の値を指定する場合は、コード・リストを引用符で囲んでください。

このオプションを省略すると、すべてのレコード・コード (00 から FF) が処理されます。

SKIP

処理が開始される前にスキップされるレコードの数。最大値は 999 999 999 です。デフォルトは 0 です。これは、処理が最初のレコードから開始されることを意味します。

STOPAFT

スキップされるレコードの数の後から始まる、処理されるレコードの数 (SKIP オプション)。最大値は 999 999 999 です。デフォルトは 0 で、すべてのレコード (指定されている場合はスキップ後) が処理されます。

MAXDUMP

ダンプの長さ (バイト単位)。レコードの先頭から始まります。デフォルトは、レコード全体の長さです。 1 から 99 999 の範囲の任意の整数を入力できます。例えば、 MAXDUMP(128)を指定すると、入力レコードの最初の 128 バイトのみがダンプされます。

注: 一部の IFCID レコードの長さは、最大 32 KB です。 MAXDUMP (レコード全体) のデフォルトを使用すると、非常に大きなレポートが作成される可能性があります。

DUMP の使用例

この例では、それぞれ次の意味を持つとします。

DUMP の名前は DUMPSTAT です。
入力データ・セットの DD 名は INPUTDD (GLOBAL のデフォルト) です。
オフセット 4 は、レコードの 5 番目のバイトにレコード・コードを定義します。
5 バイト目の 01 または 02 の値を持つレコードのみがダンプされます。
入力データ・セットの最初の 125 レコードはスキップされます。
指定を満たす次の 10 個のレコードがダンプされます。
各レコードの最初の 1 000 バイトのみがダンプされます。

DUMPSTAT DUMP (
EXEC    (INPUTDD)
OFFSET  (4)
CODES   ('01,02')
SKIP    (125)
STOPAFT (10)
MAXDUMP (1000))

注: DUMP および TAPECOPY コマンドのサンプル JCLも参照してください。