rcdmqimg (メディア・イメージの記録)

メディア・リカバリー用に、オブジェクトまたはオブジェクト・グループのイメージをログに書き込みます。

目的

rcdmqimg コマンドは、1 つのオブジェクトまたはオブジェクトのグループのイメージを、メディア・リカバリー用にログに書き込む場合に使用します。このコマンドは、リニア・ロギングを使用する場合にのみ使用できます。リニア・ロギングについて詳しくは、ロギングのタイプを参照してください。これに関連したコマンド rcrmqobj は、そのイメージからオブジェクトを再作成するために使用します。

IBM® MQ 9.1.0より前、または LogManagement=Manualを使用する場合、コマンドは自動的に実行されません。これは、 IBM MQの個々のお客様の使用法に応じて決定されたとおりに実行する必要があるためです。

IBM MQ 9.1.0の後、 LogManagement=「自動」 または 「アーカイブ」を使用すると、キュー・マネージャーは自動的にメディア・イメージを記録しますが、必要に応じて rcdmqimg を手動で実行することもできます。

rcdmqimg を実行すると、ログ順序番号 (LSN) が 1 つ進み、以前のログ・ファイルがアーカイブまたは削除用に解放されます。

rcdmqimg を実行するタイミングと頻度を決定する際は、以下の要因を考慮します。

ディスク・スペース: ディスク・スペースが制限されている場合は、rcdmqimg を定期的に実行することで、ログ・ファイルをアーカイブまたは削除用に解放します。
通常のシステム・パフォーマンスへの影響: システム上のキューが深い場合、rcdmqimg アクティビティーに長い時間がかかることがあります。このとき、データがキュー・ファイルからログにコピーされているため、システムのその他の使用の速度が低下し、ディスクの使用率が増加します。そのため、rcdmqimg を実行する理想的なタイミングは、キューが空でシステムの使用負荷が高くないときです。

このコマンドは、アクティブなキュー・マネージャーに対して使用します。その後のキュー・マネージャーでの活動は、ログで記録されます。これは、イメージが最新のものでなくなったとしても、ログ・レコードによってオブジェクトに対する変更が明らかになるようにするためです。

Syntax

必要なパラメーター

GenericObjName

記録するオブジェクトの名前。このパラメーターには、後ろにアスタリスクが付いている場合があります。このアスタリスクは、アスタリスクの前の文字列と一致する名前を持つオブジェクトが記録されることを示すものです。

キュー・マネージャーのオブジェクトまたはチャネル同期ファイルを記録している場合を除き、このパラメーターが必要です。チャネル同期ファイルに指定するオブジェクト名は、すべて無視されます。

-t ObjectType

イメージを記録するオブジェクトのタイプ。有効なオブジェクト・タイプは次のとおりです。

表 1. 有効なオブジェクト・タイプ
オブジェクト・タイプ	説明
allと*	すべてのオブジェクト・タイプ。objtype では ALL を使用し、GenericObjName では * を使用します
authinfo	TLS チャネル・セキュリティーで使用するための認証情報オブジェクト
channel または chl	チャネル
clntconn または clcn	クライアント接続チャネル
catalog または ctlg	オブジェクト・カタログ
listener または lstr	リスナー
namelist または nl	名前リスト
process または prcs	Processes
queue または q	すべてのタイプのキュー
qalias または qa	別名キュー
qlocal または ql	ローカル・キュー
qmodel または qm	モデル・キュー
qremote または qr	リモート・キュー
qmgr	キュー・マネージャー・オブジェクト
service または srvc	サービス
syncfile	チャネル同期ファイル。
topic または top	トピック

注: IBM MQ for AIX® or Linux® システムを使用する場合、シェルがアスタリスク (*) などの特殊文字の意味を解釈しないようにする必要があります。これを行う方法は、使用しているシェルによって異なりますが、単一引用符 (')、二重引用符 (") の使用を伴う場合があります。または円記号 (¥)。

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

-m QMgrName: イメージを記録するキュー・マネージャーの名前。このパラメーターを省略すると、コマンドは、デフォルトのキュー・マネージャーに対して操作を実行します。
-z: エラー・メッセージを抑制します。
-l: キュー・マネージャーを再始動してメディアのリカバリーを実行するために必要な、最も古いログ・ファイルの名前を含むメッセージを書き込みます。メッセージはエラー・ログおよび標準エラー宛先に書き込まれます。 (-z および -l の両方のパラメーターを指定した場合、メッセージはエラー・ログに送られますが、標準エラー宛先には送られません。)
rcdmqimg コマンドのシーケンスを発行するとき、-l パラメーターをシーケンス内の最後のコマンドにだけ含めて、ログ・ファイル情報が一回だけ収集されるようにします。

戻りコード

表 2. 戻りコードの ID と説明
戻りコード	説明
0	正常な操作です。
26	キュー・マネージャーはスタンバイ・インスタンスとして実行中です。
28	メディア・リカバリーが不可能なオブジェクトです。
36	与えられた引数が無効です。
40	キュー・マネージャーが利用不能です。
49	キュー・マネージャーが停止中です。
58	複数のインストール済み環境が矛盾して使用されていることが検出されました
68	メディア・リカバリーはサポートされていません。
69	ストレージが利用不能です。
71	予期しないエラーです。
72	キュー・マネージャー名のエラーです。
119	ユーザーは許可を与えられていません。
128	処理されたオブジェクトはありません。
131	リソース問題です。
132	オブジェクトが損傷しました。
135	一時オブジェクトを記録できません。

ログ・エクステントが削除されるタイミング

ログ・エクステントが削除されるのは、キュー・マネージャーが削除できると判断したときだけです。メディア・イメージの記録直後にログ・エクステントは削除されないことに注意してください。

例えば、開始メディア・エクステントが 04 の場合、キュー・マネージャーはエクステント番号が順方向に進むまでそのエクステントを削除しません。キュー・マネージャーはエクステント 01 から 04 までを削除する場合もあれば削除しない場合もあります。

ロガー・イベント・メッセージおよび IBM MQ キュー・マネージャー・エラー・ログには、キュー・マネージャーの再始動およびメディア・リカバリーに必要なログ・エクステントが表示されます。

例

次のコマンドは、キュー・マネージャー・オブジェクト saturn.queue.manager のイメージをログに記録します。

rcdmqimg -t qmgr -m saturn.queue.manager