キューの属性

この情報は、様々なタイプのキュー定義と、それぞれのタイプでサポートされている属性について学習するために使用してください。

キューのタイプ: キュー・マネージャーは、以下のタイプのキュー定義をサポートしています。
ローカル・キュー
これは、メッセージを格納する物理キューです。 このキューはローカル・キュー・マネージャー上に存在します。

ローカル・キュー・マネージャーに接続しているアプリケーションは、 このタイプのキューに対してメッセージを書き込んだり、メッセージを削除したりできます。 QType キュー属性の値は QTLOC です。

共用キュー
これは、メッセージを格納する物理キューです。 このキューは共有リポジトリー内に存在します。その共有リポジトリーを所有するキュー共有グループに属するすべてのキュー・マネージャーからアクセス可能です。
キュー共有グループ内のキュー・マネージャーに接続しているアプリケーションは、 このタイプのキューに対してメッセージを書き込んだり、メッセージを削除したりできます。 このようなキューは、実質的にはローカル・キューと同じです。 QType キュー属性の値は QTLOC です。
  • 共用キューは、 z/OS®でのみサポートされます。
クラスター・キュー
これは、メッセージを格納する物理キューです。 このキューは、ローカル・キュー・マネージャー上か、ローカル・キュー・マネージャーと同じクラスターに所属する 1 つ以上のキュー・マネージャー上の、いずれかに存在します。

ローカル・キュー・マネージャーに接続しているアプリケーションは、 キューの場所にかかわらず、このタイプのキューに対してメッセージを書き込んだり、メッセージを削除したりできます。 キューのインスタンスがローカル・キュー・マネージャー上にある場合、そのキューの振る舞いはローカル・キューと同じで、ローカル・キュー・マネージャーに接続されたアプリケーションはそのキューからメッセージを削除できます。 QType キュー属性の値は QTCLUS です。

別名キュー
これは物理キューではなく、ローカル・キューの代替名です。 別名を解決したときのローカル・キュー名は、別名キューの定義の一部です。

ローカル・キュー・マネージャーに接続されたアプリケーションは、別名キューにメッセージを置いたり、別名キューからメッセージを削除したりできます。置かれたり削除されたりするメッセージの位置は、別名を解決したときのローカル・キューです。 QType キュー属性の値は QTALS です。

リモート・キュー
これは物理キューではなく、リモート・キュー・マネージャー上に存在するキューのローカル定義です。 リモート・キューのローカル定義には、 リモート・キュー・マネージャーにメッセージを経路指定する方法を、 ローカル・キュー・マネージャーに示す情報が入っています。

ローカル・キュー・マネージャーに接続されたアプリケーションは、リモート・キューにメッセージを置くことができます。置かれるメッセージの位置は、メッセージをリモート・キュー・マネージャーに送付するために使用されるローカル伝送キューです。 アプリケーションは、リモート・キューからメッセージを除去することはできません。 QType キュー属性の値は QTREM です。

リモート・キュー定義は、以下の目的にも使用できます。
  • 応答キューへの別名割り当て

    この場合、定義の名前は、 応答先のキューの名前です。 詳しくは、 応答先キュー別名定義を参照してください。

  • キュー・マネージャーの別名割り当て

    この場合、定義の名前は、キューの名前ではなく キュー・マネージャーの別名です。 詳しくは、 キュー・マネージャー別名定義を参照してください。

モデル・キュー
これは、物理的なキューではありません。キュー属性の 1 セットであり、 これを基にしてローカル・キューを作成することができます。

このタイプのキューには メッセージを保管できません。

キュー属性には、すべてのタイプのキューに適用される属性と、特定のタイプのキューにのみ適用される属性があります。 属性が適用されるキューのタイプは、 表 1 および後続の表の「X」で示されています。
表 1 は、キューに固有の属性を要約したものです。 属性の説明は、アルファベット順に掲載しています。

この表で示されている属性の名前は、MQINQ 呼び出しおよび MQSET 呼び出しで使用する名前です。 MQSC コマンドを使用して属性を定義、変更、または表示する場合、代替ショート・ネームが使用されます。詳しくは、 MQSC コマンド を参照してください。

以下の表では、列は次のように適用されます。
  • ローカル・キューの列は、共有キューにも適用されます。
  • モデル・キューの列は、そのモデル・キューを基にして作成された ローカル・キューに継承される属性を示しています。
  • クラスター・キューの列は、 照会のみ、または照会と出力を目的としてクラスター・キューがオープンされた場合に 照会できる属性を示しています。 照会に加えて、 入力、ブラウズ、または設定のうち 1 つ以上の作業を目的としてクラスター・キューがオープンされた場合は、 代わりにローカル・キューの列が適用されます。
表 1. キューの属性
属性 説明 ローカル モデル 別名 リモート クラスター
AlterationDate 定義が最後に変更された日付 X X X
AlterationTime 定義が最後に変更された時刻 X X X
BackoutRequeueQName 超過バックアウト再キューイング用のキュー名 X X
BackoutThreshold バックアウトしきい値 X X
BaseQName 別名が解決されるキュー名 X
ClusterChannelName クラスター送信側チャネル名 X X      
ClusterName キューが属するクラスターの名前 X X X
ClusterNamelist キューが属するクラスターの名前を含む名前リスト・オブジェクトの名前 X X X
CreationDate キューが作成された日付 X
CreationTime キューが作成された時刻 X
CurrentQDepth 現行キュー項目数 X
DefBind デフォルトのバインド X X X X
DefinitionType キュー定義タイプ X X
DefInputOpenOption デフォルト入力オープン・オプション X X
DefPersistence デフォルトのメッセージ持続性 X X X X X
DefPriority デフォルトのメッセージ優先順位 X X X X X
DistLists 配布リスト・サポート X X
HardenGetBackout 正確なバックアウト・カウントを維持するかどうか X X
InhibitGet このキューに対する読み取り操作が可能かどうかを制御する X X X
InhibitPut このキューに対する書き込み操作が可能かどうかを制御する X X X X X
InitiationQName 開始キューの名前 X X
MaxMsgLength メッセージの最大長 (バイト数)。 X X
MaxQDepth キューの最大長 X X
MediaLog 最も古いログ・エクステント ( IBM i では最も古いジャーナル・レシーバー) の ID 指定されたキューのメディア・リカバリーに必要 X X
MsgDeliverySequence メッセージ・デリバリー・シーケンス X X
OpenInputCount 入力のためのオープンの回数 X
OpenOutputCount 出力のためのオープンの回数 X
ProcessName プロセス名 X X
QDepthHighEvent キュー・サイズ上限イベントが生成されるかどうかを制御する X X
QDepthHighLimit キュー・サイズの上限 X X
QDepthLowEvent キュー・サイズ下限イベントが生成されるかどうかを制御する X X
QDepthLowLimit キュー・サイズの下限 X X
QDepthMaxEvent 「キュー・フル」イベントを生成するかどうかを制御します X X
QDesc キューの記述 X X X X X
QName キュー名 X   X X X
QServiceInterval キュー・サービス間隔の目標値 X X
QServiceIntervalEvent サービス間隔上限イベントまたはサービス間隔 OK イベントを生成するかどうかを制御 X X
QType キュー・タイプ X X X X
RemoteQMgrName リモート・キュー・マネージャーの名前 X
RemoteQName リモート・キューの名前 X
RetentionInterval 保存間隔 X X
範囲 キューの項目がセル・ディレクトリーにも存在するかどうかを制御 X X X
共有可能性 キューの共有可能性 X X
TriggerControl トリガー制御 X X
TriggerData トリガー・データ X X
TriggerDepth トリガー項目数 X X
TriggerMsgPriority トリガーのしきい値メッセージ優先順位 X X
TriggerType トリガー・タイプ X X
使用法 キューの使用法 X X
XmitQName 伝送キュー名 X