IBM i でのキュー・マネージャー・ジャーナル

ここでは、 IBM® MQ for IBM i がその操作でジャーナルを使用してローカル・オブジェクトの更新を制御する方法について説明します。

各キュー・マネージャー・ライブラリーにはそのキュー・マネージャーのジャーナルが含まれ、ジャーナルの名前は QM GRLIB/AMQ A JRNとなります。ここで、 QM GRLIB はキュー・マネージャー・ライブラリーの名前、 A はキュー・マネージャー・インスタンスに固有の文字 A (単一インスタンス・キュー・マネージャーの場合) です。

QM GRLIB は、 QMという名前の後に、固有の形式でキュー・マネージャーの名前を付けます。例えば、TEST という名前のキュー・マネージャーは、QMTEST という名前のキュー・マネージャー・ライブラリーを持ちます。 CRTMQM コマンドを使用してキュー・マネージャーを作成するときに、キュー・マネージャー・ライブラリーを指定することができます。

ジャーナルには、ジャーナル処理される情報を入れるジャーナル・レシーバーが関連付けられます。レシーバーは、情報が一方的に追加されるオブジェクトであり、最終的には満杯になります。

ジャーナル・レシーバーは、古くなった情報で貴重なディスク・スペースを浪費してしまいます。ただし、情報を永続ストレージに入れることにより、この問題を最小限にとどめることができます。どの時点でも、ジャーナルにはジャーナル・レシーバーが 1 つ接続されています。ジャーナル・レシーバーが既定のしきい値に達した場合には、切り離して新しいジャーナル・レシーバーで置き換えます。 CRTMQM および THRESHOLD パラメーターを使用してキュー・マネージャーを作成するときには、ジャーナル・レシーバーのしきい値を指定できます。

ローカル IBM MQ for IBM i ジャーナルに関連付けられているジャーナル・レシーバーは、各キュー・マネージャー・ライブラリーに存在し、以下のような命名規則を採用しています。

AMQ Arnnnnn

説明:

A: 文字 A-Z を示します。単一インスタンスのキュー・マネージャーの場合、これは A になります。これは、複数インスタンスのキュー・マネージャーのインスタンスによって異なります。
nnnnn: シーケンス内の次のジャーナルのために 1 ずつ増分される 10 進数 00000 to 99999 です。
r: 10 進数の 0 to 9で、レシーバーが復元されるたびに 1 ずつ増分されます。

ジャーナルの順序は日付に基づいています。ただし、次のジャーナルは次の規則に基づいて指定されます。

AMQArnnnnn は AMQAr(nnnnn+1) になり、99999 に達すると nnnnn は折り返します。例えば、AMQA099999 は AMQA000000 になり、AMQA999999 は AMQA900000 になります。
規則 1 によって生成された名前を持つジャーナルが既に存在する場合、メッセージ CPI7OE3 が QSYSOPR メッセージ・キューに送信され、自動レシーバー切り替えは停止します。
現在接続されているレシーバーは、問題を調べて新しいレシーバーを手動で接続するまで引き続き使用されます。
新しい名前を順序どおりに使用できない (つまり、すべてのジャーナル名がシステム上にある) 場合は、次の両方を実行する必要があります。
1. 不要になったジャーナルを削除します ( IBM i を参照)。
2. (RCDMQMIMG) を使用してジャーナルの変更を最後のジャーナル・レシーバーに記録し、次に前の手順を繰り返す。このようにすると、古いジャーナル・レシーバーの名前を再使用できます。

AMQAJRN ジャーナルは MNGRCV(*SYSTEM) オプションを使用して、しきい値に達した場合に、オペレーティング・システムがジャーナル・レシーバーを自動的に変更できるようにします。システムがレシーバーを管理する方法の詳細については、「 IBM i バックアップおよび回復」を参照してください。

ジャーナル・レシーバーのデフォルトのしきい値は、100,000 KB です。キュー・マネージャーを作成するときに、これより大きな値に設定できます。ログ受信側のサイズ属性の初期値は、 mqs.ini ファイルのログ・デフォルトスタンザに書き込まれます。

ジャーナル・レシーバーが指定されたしきい値を超えて拡張されると、レシーバーは切り離され、新しいジャーナル・レシーバーが作成されて、前のレシーバーから属性を継承します。キュー・マネージャーが作成された後の LogReceiverSize 属性または LogASP 属性の変更は、システムが自動的に新しいジャーナル・レシーバーを接続するときに無視されます。

システムの構成について詳しくは、 Multiplatforms での IBM MQ 構成情報の変更を参照してください。

キュー・マネージャーの作成後にジャーナル・レシーバーのサイズを変更したい場合には、新しいジャーナル・レシーバーを作成して、次のコマンドを使用してその所有者を QMQM に設定する必要があります。

CRTJRNRCV JRNRCV(QM GRLIB/AMQ Arnnnnn) THRESHOLD(xxxxxx) +
TEXT('MQM LOCAL JOURNAL RECEIVER')
CHGOBJOWN OBJ(QM GRLIB/AMQ Arnnnnn) OBJTYPE(*JRNRCV) NEWOWN(QMQM)

説明:

QMGRLIB (QMGRLIB): ご使用のキュー・マネージャー・ライブラリーの名前
A: インスタンス ID です (通常は A)。
RNNNNN: 上記の命名順序内の次のジャーナル・レシーバー。
xxxxxx: 新しいレシーバーのしきい値 (KB 単位)
注: レシーバーの最大サイズは、オペレーティング・システムによって決まります。この値を確認するには、CRTJRNRCV コマンドの THRESHOLD キーワードを調べます。

ここで、次のコマンドを使用して、新しいレシーバーを AMQAJRN ジャーナルに付加します。

CHGJRN JRN(QMGRLIB/AMQ A JRN) JRNRCV(QMGRLIB/AMQ Annnnnn)

これらのジャーナル・レシーバーの管理方法について詳しくは、 IBM i を参照してください。