dmpmqmsg

目的

dmpmqmsg ユーティリティーを使用して、キューの内容やメッセージをファイルにコピーしたり移動したりします。

オプション・パラメーター

-m QueueManagerName

キューが存在しているキュー・マネージャーの名前。

-i または -I Input queue name

入力キューの名前。

注: -i を使用するとキューが参照され (非破壊読み取り)、 -I を使用するとキューからメッセージが削除されます (破壊読み取り)。

-f または -F Filename

ソース・ファイルまたはターゲット・ファイルいずれかの名前を指定します。

注: ターゲット・ファイルに対して -F を使用すると、ファイルが既に存在する場合は、強制的にそのファイルに出力されます。 プログラムは、ファイルを上書きするかどうかを確認しません。

-o Output queue name

出力キューの名前を指定します。

-a

以下の値のいずれかをキーワードに追加することによって、ファイルを追加モードとバイナリー・モードのどちらで開くかを制御します。

a

追加モード

b

バイナリー・モード

-c

クライアント・モードで接続します。

このフラグを選択しない場合、ユーティリティーはデフォルトのローカル・モードで実行されます。

このオプションは、 z/OS®では使用できません。

-P

キューから取得したメッセージを変換するかどうかを制御します。

次のコマンドを使用すると、

-P <CCSID> [ : X 'Encoding' ]

例えば-P850:111

-C

以下の値のいずれかをキーワードに追加することによって、コンテキスト・オプションを制御します。

A

すべてのコンテキストを設定する。 これがデフォルト値です。

I

一致コンテキストを設定する。

a

すべてのコンテキストを渡す。

p

一致コンテキストを渡す。

ソース・メッセージがキューで参照される場合、pass オプションの使用は適用されません。

d

デフォルト・コンテキスト。

n

コンテキストなし

-d

以下の値を 1 つ以上キーワードに追加することによって、表示オプションを制御します。 例えば、-dsCMです。

a

読みやすくするため、ファイルでの 16 進数出力に ASCII 列を追加する。

A

可能な限り、ASCII のデータ行を書き込む。

EBCDIC プラットフォームでは、データは代わりに EBCDIC で書き込まれます。

c

ApplicationOriginData および ApplicationIdentityData を文字として出力する。

C

キューの要約に Correlation Identifier を表示する。

H

ファイル・ヘッダーを書き込まない。

このオプションを指定して作成されたファイルは、プログラムがファイル形式を認識しないため、プログラムによってロードされません。 ただし、ファイルをロード可能にするため、必要に応じてエディターを使用し、適切なヘッダーを手動で追加することができます。

i

出力にメッセージ索引を組み込む。

p

印刷可能文字の出力形式。

この形式はコード・ページ・セーフではありません。 この形式で書き込まれたファイルをロードした場合、新しいコード・ページで実行しても、同じメッセージが生成されることが保証されません。

s

入力で検出されたメッセージの簡単な要約を書き込む。

M

キューの要約に Message Identifier を表示する。

N

メッセージ・ペイロードのみを書き出し、メッセージ記述子の内容は書き出さない。

t

テキスト行の出力形式。

この形式はコード・ページ・セーフではありません。 この形式で書き込まれたファイルをロードした場合、新しいコード・ページで実行しても、同じメッセージが生成されることが保証されません。

T

メッセージがキューに存在している時間を表示する。

w <Length>

出力のデータ幅を設定する。

-D

以下の値のいずれかをキーワードに追加することによって、メッセージを出力宛先に書き込むまでの遅延 (ミリ秒単位で表す) を追加します。 次のような例を挙げてみます。

<正の値>

メッセージを書き込む前の固定遅延を追加する。 例えば、-D500 は、各メッセージを 0.5 秒間隔で書き込みます。

<負の値>

メッセージを書き込む前に、指定した値までのランダム遅延を追加する。 例えば、-D-10000 は、メッセージを書き込む前に最大 10 秒のランダム遅延を追加します。

r <値>

元の書き込み速度に対する割合でメッセージを適用する。 以下に例を示します。

r

元の速度でメッセージを適用する。

r50

元の速度の半分の速度でメッセージを適用する。

r200

元の速度の 2 倍の速度でメッセージを適用する。

-g

以下の値のいずれかをキーワードに追加することによって、メッセージ ID、相関 ID、またはグループ ID でフィルターに掛けます。

c<値>

文字の相関 ID で取得する。

m<値>

文字のメッセージ ID で取得する。

g<値>

文字のグループ ID で取得する。

xc<値>

16 進数の相関 ID で取得する。

xm<値>

16 進数のメッセージ ID で取得する。

xg<値>

16 進数のグループ ID で取得する。

-h

ヘッダーを除去します。

メッセージが書き込まれる前に、送達不能キュー・ヘッダー (MQDLH) または伝送キュー・ヘッダー (MQXQH) をメッセージから除去します。

-o

出力キュー名。

-p

メッセージがターゲット宛先にコピーされると、ソース・キューからメッセージが消去されます。

-q

抑止モードを設定します。 設定すると、プログラムはアクティビティーの通常の要約を出力しません。

-r

注: -r オプションを 0に設定して dmpmqmsg コマンドを実行すると、コマンドは、宛先がファイルかキューかに関係なく、すべてのメッセージを宛先にコピーします。

以下の値のいずれかをキーワードに追加することによって、適用可能なメッセージ範囲を設定します。

x

メッセージ xのみ。例えば、-r10。 r が 0の場合、すべてのメッセージを宛先にコピーします。

x..y

メッセージ x からメッセージ y へ。 例: -r 10..20。 -r0..9 は、1 つから 9 つのメッセージを宛先にコピーします。

x#y

メッセージ xで始まる y メッセージを出力します。 例: -r 100#10。 ,-r0#4 は、1 つから 4 つのメッセージを宛先にコピーします。

#x

最初の x メッセージ (例えば、-r #100) を出力します。 -r \#0 は、すべてのメッセージを宛先にコピーします。

-t

トランザクション・メッセージの制限を設定します。 オプションの -n フラグが設定されていない場合は、すべてのメッセージが単一トランザクションで実行されます。

n

メッセージ操作は n 個のメッセージのグループに分割されます。 例えば、-t 1000 は、単一トランザクションで 1000 個のメッセージを処理します。

-T

メッセージの経過時間に基づいたメッセージ選択を可能にします。

メッセージの経過時間を使用した選択については、 メッセージの経過時間の使用 を参照してください。

-s または -e

メッセージの内容に基づいたメッセージ選択を可能にします。

ASCII プラットフォーム ( Windows および UNIX および Linux® ) -s オプションを使用して、ネイティブでエンコードされたストリングを検索します。EBCDIC プラットフォームの場合 ( z/OS ) ネイティブでエンコードされたストリングを検索するには、 -e オプションを使用します。

メッセージ内容を使用した選択については、 メッセージ内容の使用 を参照してください。

-w

メッセージをコンシュームするための待機間隔 (秒単位)。 これを指定した場合、プログラムは到着するメッセージを、指定された期間待機してから終了します。