dmpmqmsg (キュー・ロード/アンロード)

目的

IBM MQ 8.0以降、以前 IBM MQ Supportpac MO03で出荷されていた qload ユーティリティーが、 dmpmqmsg ユーティリティーとして IBM MQ に統合されました。

UNIX and Linux® プラットフォームでは、このユーティリティーは <installdir>./bin にあります。

Windows プラットフォームでは、このユーティリティーは、サーバー・ファイルセットの一部として <installdir>./bin64 で使用できます。

z/OS®では、このユーティリティーは、SCSQLOAD ライブラリー内の実行可能モジュール CSQUDMSG として使用でき、互換性のために別名 QLOAD を使用します。 サンプル JCL も、SCSQPROC のメンバー CSQ4QLOD として用意されています。

詳しくは、 dmpmqmsg ユーティリティーの使用を参照してください。

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

-m QueueManager名前

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

-i または -I 入力キュー名

入力キューの名前。

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

-f または -F Filename

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

注:

• ターゲット・ファイルに -F を使用すると、既にファイルが存在するなら、そのファイルに強制的に出力されます。 プログラムは、ファイルを上書きするかどうかを確認しません。
• キューのメッセージにアクセスすることを許可されていないユーザーに、出力ファイルを読み取る権限が与えられている可能性があるので、出力ファイルに適切なアクセス制御が設定されているかを確認してください。

  UNIX and Linuxでは、新規ファイルの許可は、ユーティリティーの実行時に現在の umask に従って設定されます。

  Windowsでは、新規ファイルの許可は親ディレクトリー ACL から継承されます。

-o 出力待ち行列名

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

-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

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

-Dpositive_value

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

-Dnegative_value

メッセージを書き込む前に、指定した値までのランダム遅延を追加する。 例えば、-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 個のメッセージのグループに分割されます。 例えば、-t1000 は、単一トランザクションで 1000 個のメッセージを処理します。

-T

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

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

重要: 経過時間は、メッセージ記述子 (MQMD) の PutDate フィールドおよび PutTime フィールドに基づいています。これは、ユーティリティーが実行されているシステムの UTC と比較しています。

-s または -e

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

ASCII プラットフォーム (UNIX, Linux, and Windows) では、 -s オプションを使用して、ネイティブにエンコードされたストリングを検索します。

EBCDIC プラットフォーム (z/OS) では、 -e オプションを使用して、ネイティブにエンコードされたストリングを検索します。

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

-u

-u パラメーターを使用してユーザー ID を指定する場合、対応するパスワードを求めるプロンプトが出されます。

CHCKLOCL(REQUIRED) または CHCKLOCL(REQDADM) を指定して CONNAUTH AUTHINFO レコードを構成した場合、-u パラメーターを使用する必要があります。このパラメーターを使用しないと、キューの内容をコピーしたり移動したりすることはできません。

このパラメーターを指定して stdin をリダイレクトすると、プロンプトは表示されず、リダイレクトされた入力の最初の行にパスワードが含まれます。

-w

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