dmpmqmsg
以前の IBM® MQ キュー・ロードおよびアンロード・ユーティリティー。
目的
dmpmqmsg ユーティリティーを使用して、キューの内容やメッセージをファイルにコピーしたり移動したりします。
Syntax
オプション・パラメーター
- -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 のデータ行を書き込む。
- 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
- メッセージをコンシュームするための待機間隔 (秒単位)。 これを指定した場合、プログラムは到着するメッセージを、指定された期間待機してから終了します。