2.2.2　運用コマンドによるキューファイルの運用

(1)　キューファイルの作成

ユーザは，キューの情報を格納するためのキューファイルを，mqainitコマンドを使用して作成します。このとき，キャラクタ型スペシャルファイルまたはUNIXファイルのアクセス権は，所有者およびグループにリード・ライト権を与えてください。また，OpenTP1ファイルシステムのアクセス権はユーザ用に設定してください。アクセス権を正しく設定していない場合，KFCA31184-Eが出力されてOpenTP1の起動に失敗します。

mqainitコマンドを使用すると，二つの物理ファイルが作成されます。一つは，メッセージの管理情報が格納されるメッセージ情報管理ファイルです。もう一つは，メッセージ自身が格納されるメッセージファイルです。メッセージ情報管理ファイルとメッセージファイルの合計の最大格納容量は2ギガバイトです。

注意事項

キューファイルパスおよびキューファイル名にスペースを指定しないでください。指定した場合，動作を保証できません。

ページの先頭へ

(2)　キューの作成と削除

ユーザは，メッセージキューイングに使用するキューを作成する必要があります。

キューは，作成の方法によって，定義済みキューと動的キューに分けられます。

ページの先頭へ

(3)　キューの属性の変更

キューの属性を変更する場合は，mqachgqueコマンドを使用します。mqachgqueコマンドで変更できるのは，ローカルキューの属性です。なお，キューの属性のうち，定義タイプは変更できません。

ページの先頭へ

(4)　キューファイルの状態

キューファイルには，次に示す状態があります。

正常

正常に使用できる状態です。

論理閉塞

論理的に閉塞して，メッセージの登録および取り出しができない状態です。

障害閉塞

キューファイルに障害が発生した場合の状態です。

一時的障害閉塞

キューファイルに一時的な障害が発生した場合の状態です。次に示す状態があります。

• 一時的障害閉塞（C）

  メッセージ情報管理ファイルに一時的な障害が発生した状態

• 一時的障害閉塞（CR）

  メッセージ情報管理ファイルに一時的な障害が発生したあと回復済みの状態

• 一時的障害閉塞（M）

  メッセージファイルに一時的な障害が発生した状態

• 一時的障害閉塞（C/M）

  メッセージ情報管理ファイルおよびメッセージファイルに一時的な障害が発生した状態

• 一時的障害閉塞（CR/M）

  メッセージ情報管理ファイルに一時的な障害が発生したあと回復済みであるが，メッセージファイルに一時的な障害が発生した状態

キューファイル障害発生時に，障害要因が一時的である可能性のある場合は，一時的障害閉塞に移行します。キューファイル格納媒体損傷の場合も，一時的障害閉塞に移行します。

一時的障害閉塞に移行すると，障害発生時点でキューファイルに未反映である更新情報はメモリ上に保持されます（障害閉塞に移行する場合，更新情報は破棄されます）。そのため，障害要因を除去した後に，未反映である更新情報をキューファイルに書き込むことによって回復することができます。mqafrcコマンドによって，ジャーナルファイルを使用してキューファイルを回復する必要はありません。

空き

キューファイルは存在していますが，キューマネジャに認識されていない状態です。オンラインで使用するためには，キューファイルを組み込む必要があります。

キューファイルの状態とコマンドによる状態遷移について，次の図に示します。

注1

図中の矢印以外に次に示す状態遷移があります。

• すべての「一時的障害閉塞」からmqarmコマンドによって「空き」に移行します。

• すべての「一時的障害閉塞」からmqagrpobsコマンドによって「障害閉塞」に移行します。

• 「一時的障害閉塞（C）」および「一時的障害閉塞（C/M）」から計画停止および再開始によって「障害閉塞」に移行します。

注2

TP1/Message Queueが一定の間隔（チェックポイントダンプ取得間隔または3分間隔）で回復処理を実行しているため，自動的にキューファイルの状態が移行することがあります。

「正常」から「障害閉塞」に移行するのは，次に示す場合です。

• 開始時および終了時にキューファイル障害を検知した場合

• キューファイル二重化構成の片系のキューファイル障害（片系障害）を検知した場合

これら以外でキューファイル障害を検知すると「一時的障害閉塞」に移行します。

注※1

mqarlesコマンド入力時に，メッセージ情報管理ファイルへの書き込みが成功した場合

注※2

mqarlesコマンド入力時に，メッセージ情報管理ファイルへの書き込みが失敗した場合

注意事項

すべての「一時的障害閉塞」からOpenTP1を正常終了した場合，そのキューファイルは「障害閉塞」として扱われるため，キューファイルの再作成が必要です。

ページの先頭へ

(5)　オブジェクトの属性の設定（キューに登録の許可／禁止および取り出しの許可／禁止を設定）

キューに，登録の許可／禁止および取り出しの許可／禁止を設定する場合は，mqasetコマンドを使用します。mqasetコマンドのコマンド引数によって，次に示すキューに設定できます。

• ローカルキュー

• リモートキューのローカル定義で指定されたキュー^※

• 別名キュー

  注※

  取り出しの許可／禁止は設定できません。

ページの先頭へ

(6)　オブジェクトの属性表示

オブジェクトの属性を表示する場合は，mqainqコマンドを使用します。mqainqコマンドのオプションによって，次に示すオブジェクトの属性を表示できます。

-mオプション

• キューマネジャ

-qオプション

• ローカルキュー

• モデルキュー

• リモートキューのローカル定義で指定されたキュー

• 別名キュー

ページの先頭へ

(7)　キューファイル内の情報表示

オフラインの状態で，指定したキューファイルの管理部の情報を表示するには，mqafilinfコマンドを使用します。mqafilinfコマンドのオプションによって，次に示す情報を表示できます。

-qオプション

• ローカルキュー情報

-xオプション

• キュー名一覧

ページの先頭へ

(8)　キューファイルの組み込みと切り離し

キューファイルを組み込む場合は，mqaaddコマンドを使用します。キューファイルを組み込むと，オンラインで使用できる状態になります。このあと，mqarlesコマンドを使用して閉塞状態を解除すると，キューファイルはアプリケーションから使用できる状態になります。

キューファイルを切り離す場合，mqarmコマンドを使用します。キューファイルを切り離すと，キューファイルの中のキューおよびメッセージは破棄されます。

-rオプションを指定すると，キューファイルを強制的に切り離せます。

ページの先頭へ

(9)　キューファイルの論理閉塞と閉塞解除

mqaaddコマンドでキューファイルを組み込んだ直後は，キューファイルは論理閉塞状態です。閉塞状態を解除するために，mqarlesコマンドを使用します。

また，一時的障害閉塞を解除するには，mqarlesコマンドの-sオプションにtを指定します。

ページの先頭へ

(10)　キューファイルのバックアップとリストア

キューファイルをバックアップする場合は，mqabkupコマンドを使用します。mqabkupコマンドで指定したキューファイルがオンラインで使用中の場合，この操作はエラーになります。

バックアップしたファイルをリストアするには，mqarstrコマンドを使用します。

ページの先頭へ

(11)　キューファイルの回復

キューファイルの回復をMQA FRCといいます。MQA FRCは，mqafrcコマンドで実行します。MQA FRCはキューファイルの障害要因により回復方法が異なります。

なお，mqafrcコマンドの実行を含むキューファイルの回復手順については，「7.1.4　キューファイルの入出力エラー」を参照してください。

ページの先頭へ

(12)　mqafrcコマンドの使用例（キューファイル格納媒体損傷の場合）

障害要因がキューファイル格納媒体損傷の場合の，mqafrcコマンドの使用例について説明します。使用例で指定する回復対象キューファイル定義ファイル（ファイル名mappingfile）は，次に示すとおり記述します。

mqafilmap /dev/rdsk/rhd031/rcvf1 /dev/rdsk/rhd032/rcvf1

この定義例では，回復対象キューファイル名は/dev/rdsk/rhd031/rcvf1，回復先キューファイル名は/dev/rdsk/rhd032/rcvf1です。回復先キューファイル名には，実際に回復させるキューファイル名を指定します。回復対象キューファイル名は，回復先キューファイルを回復するために必要なアンロードジャーナル内の情報を特定するために使用します。回復対象キューファイル名が示すファイルの情報を基に回復するわけではありません。mqafrcコマンドを実行する場合には回復先キューファイルが存在している必要があります。キューファイル/dev/rdsk/rhd032/rcvf1は，キューファイル/dev/rdsk/rhd031/rcvf1のバックアップを基にリストア済みで，mqafrcコマンドの入力によってキューファイル/dev/rdsk/rhd032/rcvf1は障害発生直前の状態に回復されます。

• 回復対象キューファイルのバックアップ方法

  回復対象キューファイルをバックアップするには，次に示すどちらかの方法を実行します。

  • mqabkupコマンドでOpenTP1ファイルシステム上のキューファイルをOSのファイルにバックアップ

  • OpenTP1ファイルシステムをfilbkupコマンドでバックアップ

• 回復先キューファイルのリストア方法

  バックアップを回復先キューファイルにリストアするには，次に示すどちらかの方法を実行します。

  • mqabkupコマンドでバックアップしたキューファイルをmqarstrコマンドでOpenTP1ファイルシステムにリストア

  • filbkupコマンドでバックアップしたOpenTP1ファイルシステムをfilrstrコマンドに-rオプションを指定してOpenTP1ファイルシステムにリストア

mqafrcコマンドに指定するアンロードジャーナルファイル名は次に示すとおりとします。

jnlf001，jnlf002，…，jnlf00n…（n：世代番号）

mqafrc -s -e -f mappingfile /jnlf001

mqafrc -s -e -f mappingfile /jnlf001 /jnlf002 /jnlf003

mqafrc -s -e -g -f mappingfile /jnlf002 /jnlf003

mqafrc -s -k 005 -f mappingfile /jnlf001

ページの先頭へ

(13)　mqafrcコマンドの使用例（キューファイル格納媒体損傷以外の場合）

障害要因がキューファイル格納媒体損傷以外の場合の，mqafrcコマンドの使用例について説明します。使用例で指定する回復対象キューファイル定義ファイル（ファイル名mappingfile）は，次に示すとおり記述します。

mqafilmap /dev/rdsk/rhd031/rcvf1

この定義例では，回復対象キューファイル名および回復先キューファイル名はともに/dev/rdsk/rhd031/rcvf1です。回復先キューファイル名には，実際に回復させるキューファイル名を指定します。mqafrcコマンドを実行する場合には回復先キューファイルが存在している必要があります。キューファイル/dev/rdsk/rhd031/rcvf1は障害発生直前の状態に回復されます。

mqafrcコマンドに指定するアンロードジャーナルファイル名は次に示すとおりとします。

jnlf001，jnlf002，…，jnlf00n…（n：世代番号）

mqafrc -s -e -f mappingfile /jnlf001

ページの先頭へ

(14)　キューファイルの削除

キューファイルを削除する場合は，mqadelコマンドを使用します。mqadelコマンドを実行すると，指定したキューファイルに対応するメッセージ情報管理ファイルとキューファイルの二つが削除されます。

オンラインで使用中のキューファイルは削除できません。オンラインで使用中のキューファイルを指定した場合，エラーになります。

ページの先頭へ

(15)　キューファイル二重化構成

MQAサービス定義のmqaquegrp定義コマンドで，指定したキューファイル名（A系ファイル名）に対するバックアップキューファイル名（B系ファイル名）を指定できます。この指定によって，A系またはB系のどちらかのキューファイルに障害が発生すると，もう一方の系統のキューファイルを使用して運用を行います。キューファイルの二重化は，ユーザアプリケーションが意識することなく行われます。また，キューファイルは，同期を取って更新しているので，A系またはB系だけに，メッセージが残ったり消えたりすることはありません。

障害が発生したファイルを回復する場合はmqarcvrコマンドを使用します。これによって，現在使用中の系統キューファイルと情報が同じになります。

ファイル障害の詳細については，「7.1.4　キューファイルの入出力エラー」を参照してください。

注意事項

• A系またはB系の物理ファイルは複数のディスクに分散させて作成してください。一つのディスク上に同じ系統のすべての物理ファイルを作成すると，ディスクの全面障害が発生した場合，その系統は使用できません。

• 動的キューを作成するには，A系ファイル用のmqaqueatl定義をMQAサービス定義ファイル（$DCCONFPATH/mqa）に作成してください。

キューファイル二重化構成は，次に示すどちらかの手順で定義および作成します。

手順1

1. mqabkupコマンドでキューファイルをバックアップします。

2. 1.でバックアップしたキューファイルをmqarstrコマンドでリストアします。これがバックアップキューファイル（B系ファイル）になります。

3. 1.および2.で作成したキューファイルの名前をMQAサービス定義のmqaquegrp定義コマンドにA系ファイル名およびB系ファイル名として指定します。

手順2

1. mqainitコマンドでA系ファイルおよびB系ファイルを作成します。

   同じオプション指定値でキューファイルを作成してください。

2. A系ファイルおよびB系ファイルについて，mqaqueatl定義を作成します。

   モデルキューの定義名およびキューファイル名以外のオプション指定値は同じにしてください。

   A系ファイル用のmqaqueatl定義およびB系ファイル用のmqaqueatl定義は，キュー属性定義ファイル（UNIXテキストファイル）に作成してください。

3. mqamkqueコマンドで同じ名前のキューを作成します。

4. 1.で作成したキューファイルの名前をMQAサービス定義のmqaquegrp定義コマンドにA系ファイル名およびB系ファイル名として指定します。

なお，キューファイル二重化構成は，キューファイル二重化構成しない場合に比べて性能が低下します。

ページの先頭へ

(16)　キューファイルグループの使用状況表示

キューファイルグループの使用状況を表示する場合は，mqadfコマンドを使用します。表示されるキューファイルグループの使用状況の項目について，次に示します。

• キューファイルグループの全キューの個数

• 使用中のキューの個数

• 未使用キューの個数

• メッセージ格納領域の容量

• メッセージ格納領域の使用容量

• メッセージ格納領域の空き容量

ページの先頭へ

(17)　キューファイルの情報表示

キューファイル名の一覧およびキューファイルの情報を表示する場合は，mqafillsコマンドを使用します。

mqafillsコマンドで-xオプションを指定すると，MQAサービスで使用中のすべてのキューファイル名が表示されます。mqafillsコマンドの-fオプションにキューファイル名を指定すると，指定したキューファイルの情報が表示されます。次に示す項目などが表示されます。

• キューファイル名

• キューファイルの状態

• 全キューの個数

• 使用中キューの個数

• 未使用キューの個数

• メッセージ長

• メッセージ情報管理ファイルのレコード長

• メッセージ情報管理ファイルのレコード数

• ファイル形態

ページの先頭へ

(18)　キューファイルのコンバート

キューファイルをコンバートする場合は，mqaconvertコマンドを使用します。過去のバージョンで使用していたTP1/Message Queueのキューファイルを，現在のバージョンで使用する場合は，mqaconvertコマンドでキューファイルをコンバートする必要があります。

mqaconvertコマンドを使用すると，mqabkupコマンドでバックアップした旧バージョンのキューファイル（メッセージ情報管理ファイル（キューファイル名.cnt），およびメッセージファイル（キューファイル名.msg））を，最新バージョンのキューファイルへコンバートできます。なお，mqaconvertコマンドを使用する際は，次の点に注意してください。

• 古いバージョンへのコンバートはできません。

• このコマンドでコンバートできるのは，TP1/Message Queue 05-00以降で作成したバックアップファイルです。

キューファイルのコンバートは，次に示す手順で行います。

1. 過去のバージョン環境で，mqabkupコマンドで変換元となるキューファイルをバックアップします。

2. 使用したいバージョン環境に変更します。

3. mqaconvertコマンドで，使用するキューファイルを変換します。

ページの先頭へ

(19)　メッセージの削除

キュー名に登録されているメッセージを削除する場合は，mqadelmsgコマンドを使用します。

ページの先頭へ

(20)　メッセージの表示

キュー名に登録されているメッセージ情報を表示する場合は，mqalsmsgコマンドを使用します。表示される情報の項目について，次に示します。

• MQMD構造体の内容

• メッセージ内容

ページの先頭へ