DEFINE キュー

MQSC DEFINE コマンドは、ローカル・キュー、モデル・キュー、またはリモート・キュー、あるいはキュー別名、応答先キュー別名、キュー・マネージャー別名を定義するために使用します。

MQSC コマンドの使用

MQSC コマンドの使用方法については、 MQSC コマンドを使用したローカル管理タスクの実行を参照してください。

このセクションでは、次のコマンドを取り上げます。DEFINE QREMOTE コマンドを使用して、応答先キューまたはキュー・マネージャー別名を定義します。

[z/OS]このコマンドはソースから発行できます 2CRソースのシンボルの説明については、 z/OS®で MQSC コマンドを発行できるソースを参照してください。

DEFINE queues の使用上の注意

  • コマンドが正常に完了しても、アクションが完了したことを意味するわけではありません。 真の完了を確認するには、 分散ネットワークの非同期コマンドが終了したことの確認DEFINE キュー のステップを参照してください。
  • ローカル・キューの場合
    1. [z/OS]キュー共有グループ内の別のキュー・マネージャーが既にローカル・バージョンのキューを持っている場合でも、 QSGDISP(SHARED) を使用してローカル・キューを定義できます。 ただし、ローカル定義キューにアクセスしようとすると、理由コード MQRC_OBJECT_NOT_UNIQUE (2343) で失敗します。 同じ名前を持つキューのローカル・バージョンは、タイプ QLOCALQREMOTE、または QALIAS にすることができ、属性指定 QSGDISP(QMGR)を持つことができます。

      この競合を解決するには、DELETE コマンドを使用して、いずれかのキューを削除する必要があります。 削除するキューにメッセージが含まれている場合は、PURGE オプションを使用するか、または MOVE コマンドを使用してメッセージを最初に除去します。

      例えば、メッセージが含まれる QSGDISP(LOCAL) バージョンを削除し、これらのメッセージを QSGDISP(SHARED) バージョンにコピーする場合は、以下のコマンドを発行します。
      
      MOVE QLOCAL(QUEUE.1) QSGDISP(PRIVATE) TOQLOCAL(QUEUE.1) TYPE(ADD)
      DELETE QLOCAL(QUEUE.1) QSGDISP(QMGR)
      
  • 別名キューの場合 :
    1. DEFINE QALIAS( aliasqueue ) TARGET( otherqname ) CLUSTER( c ) は、 aliasqueueという名前でキュー otherqname を公示します。
    2. DEFINE QALIAS( aliasqueue ) TARGET( otherqname ) では、 otherqname という名前で通知されたキューを、 aliasqueueという名前でこのキュー・マネージャーで使用することができます。
    3. TARGTYPE および TARGET はクラスター属性ではありません。つまり、クラスター環境内では共有されていません。
  • リモート・キューの場合 :
    1. DEFINE QREMOTE( rqueue ) RNAME( otherq ) RQMNAME( otherqm ) CLUSTER( cl ) は、このキュー・マネージャーを、キュー rqueue のメッセージを送信できるストア・アンド・フォワード・ゲートウェイとして公示します。 ローカル・キュー・マネージャー以外では、このコマンドに応答先キューの別名としての効果はありません。

      DEFINE QREMOTE( otherqm ) RNAME() RQMNAME( anotherqm ) XMITQ( xq ) CLUSTER は、このキュー・マネージャーを、 anotherqm のメッセージを送信できるストア・アンド・フォワード・ゲートウェイとして通知します。

    2. RQMNAME は、それ自体をクラスター内のクラスター・キュー・マネージャーの名前にすることができます。 したがって、(QALIAS 定義と同様に) 公示されたキュー・マネージャー名を、ローカル側で別の名前にマッピングすることができます。 パターンは QALIAS 定義の場合と同様です。
    3. RQMNAME 自体がクラスター・キュー・マネージャーである場合は、 RQMNAMEQREMOTE の値を同じにすることができます。 この定義についても CLUSTER 属性を使用して公示した場合は、クラスター・ワークロード出口でローカル・キュー・マネージャーを選択しないでください。 そのように選択すると、循環定義になってしまいます。
    4. リモート・キューは、ローカル側で定義する必要はありません。 この利点としては、アプリケーションは単純なローカル定義名でそのキューを参照できるので便利だという点です。 この場合、キュー名はキューがあるキュー・マネージャーの名前で修飾されます。 ローカル定義を使用するときには、アプリケーションがそのキューの実際の位置を知らなくてもかまいません。
    5. リモート・キュー定義は、キュー・マネージャーの別名定義や、応答先キューの別名定義を保持するための手段としても利用できます。 その場合、定義の名前は次のいずれかになります。
      • キュー・マネージャー名。別のキュー・マネージャー名の別名 (キュー・マネージャーの別名) として使用されます。
      • キュー名。応答先キューの別名 (応答先キュー別名) として使用されます。

DEFINE QUEUE および ALTER QUEUE のパラメーターの説明

表 1 に、各タイプのキューに関連するパラメーターを示します。 表の下に、各パラメーターの説明を示します。
キュー名
キューのローカル名。ただし、リモート・キューのローカル定義に使用されているリモート・キューは除きます。
IBM® MQ オブジェクトの命名規則を参照してください。
ACCTQ
キューのアカウンティング・データ収集を使用可能にするかどうかを指定します。 z/OSでは、収集されるデータはクラス 3 アカウンティング・データ (スレッド・レベルおよびキュー・レベルのアカウンティング) です。 このキューでアカウンティング・データを収集するには、この接続のアカウンティング・データも使用可能にする必要があります。 ACCTQ キュー・マネージャー属性、または MQCONNX 呼び出しの MQCNO 構造体のオプション・フィールドのいずれかを設定して、アカウンティング・データ収集をオンにします。
QMGR
アカウンティング・データの収集は、キュー・マネージャー定義のACCTQパラメーターの設定に基づきます。
ON
ACCTQキュー・マネージャー・パラメーターの値が NONE でない限り、キューのアカウンティング・データ収集は有効になります。
[z/OS] z/OS システムでは、 START TRACE コマンドを使用してクラス 3 アカウンティングを使用可能にする必要があります。
オフ
このキューではアカウンティング・データ収集は使用不可になります。
BOQNAME (キュー名)
過度バックアウト・リキュー名。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

このパラメーターは、ローカル・キューまたはモデル・キューのバックアウト・キュー名属性を設定または変更するときに使用します。 キュー・マネージャーは、その値を照会できるようにする以外には、この属性の値に基づいて何も行いません。 IBM MQ classes for JMS は、最大回数バックアウトされたメッセージをこのキューに転送します。 最大値は、BOTHRESH属性によって指定されます。

BOTHRESH (整数)
バックアウトしきい値。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

このパラメーターは、ローカル・キューまたはモデル・キューのバックアウトしきい値属性の値を設定または変更するときに使用します。 キュー・マネージャーは、その値を照会できるようにする以外には、この属性の値に基づいて何も行いません。 IBM MQ classes for JMS は、この属性を使用して、メッセージのバックアウトを許可する回数を決定します。 この値を超えると、メッセージは BOQNAME 属性で指定されたキューに転送されます。

値は 0 から 999,999,999 の範囲で指定します。

[z/OS]CFSTRUCT (構造名)
共有キューを使用する際にメッセージを保管するカップリング・ファシリティー構造の名前を指定します。

このパラメーターは、ローカル・キューおよびモデル・キューの z/OS でのみサポートされます。

名前には次の条件があります。
  • 12 文字より長くすることはできません。
  • 先頭の文字は大文字 (A から Z) でなければなりません。
  • 使用できる文字は A から Z と 0 から 9 だけです。

指定した名前には、キュー・マネージャーが接続されるキュー共有グループの名前が接頭部として付きます。 キュー共有グループの名前は必ず 4 文字で、必要に応じて記号 @ が埋め込まれます。 例えば、NY03という名前のキュー共有グループを使用し、PRODUCT7という名前を指定した場合、結果のカップリング・ファシリティー構造体名はNY03PRODUCT7になります。 キュー共有グループの管理構造体 (この場合はNY03CSQ_ADMIN) をメッセージの保管に使用することはできません。

ALTER QLOCALALTER QMODELREPLACEを指定した DEFINE QLOCAL 、および REPLACE を指定した DEFINE QMODEL の場合は、以下の規則が適用されます。
  • QSGDISP(SHARED) が指定されたローカル・キューでは、CFSTRUCTは変更できません。
  • CFSTRUCTまたはQSGDISPのいずれかの値を変更した場合は、キューを削除して再定義する必要があります。 キュー上のメッセージを保持するには、キューを削除する前にメッセージをオフロードする必要があります。 キューを再定義した後にメッセージを再ロードするか、メッセージを別のキューに移動してください。
  • DEFTYPE(SHAREDYN) のモデル・キューでは、CFSTRUCTをブランクにすることはできません。
  • SHARED 以外のQSGDISPを持つローカル・キュー、または SHAREDYN 以外のDEFTYPEを持つモデル・キューでは、CFSTRUCTの値は問題になりません。
NOREPLACE を使用する DEFINE QLOCAL および NOREPLACEを使用する DEFINE QMODEL の場合、カップリング・ファシリティー構造は以下のようになります。
  • QSGDISP(SHARED) が指定されたローカル・キュー、または DEFTYPE(SHAREDYN) が指定されたモデル・キューでは、CFSTRUCTをブランクにすることはできません。
  • SHARED以外のQSGDISPを持つローカル・キュー、またはSHAREDYN以外のDEFTYPEを持つモデル・キューでは、CFSTRUCTの値は問題になりません。
注: キューを使用する前に、カップリング・ファシリティー・リソース管理 (CFRM) ポリシー・データ・セットで構造を定義する必要があります。
CLCHNAME (チャネル名)

このパラメーターは、伝送キューでのみサポートされます。

CLCHNAMEは、このキューを伝送キューとして使用するクラスター送信側チャネルの総称名です。 この属性は、このクラスター伝送キューからクラスター受信側チャネルへメッセージを送信するクラスター送信側チャネルを指定します。

また、伝送キュー属性であるCLCHNAME属性をクラスター送信側チャネルに手動で設定することもできます。 クラスター送信側チャネルによって接続されたキュー・マネージャーを宛先とするメッセージは、クラスター送信側チャネルを識別する伝送キューに保管されます。 これらのメッセージがデフォルトのクラスター伝送キューに保管されることはありません。 CLCHNAME属性をブランクに設定すると、チャネルの再始動時にチャネルはデフォルトのクラスター伝送キューに切り替わります。 デフォルト・キューは、キュー・マネージャーのDEFCLXQ属性の値に応じて、SYSTEM.CLUSTER.TRANSMIT.ChannelNameまたはSYSTEM.CLUSTER.TRANSMIT.QUEUEのいずれかになります。

CLCHNAMEでアスタリスク*を指定することにより、伝送キューをクラスター送信側チャネルのセットに関連付けることができます。 アスタリスクはチャネル名ストリングの先頭、末尾、またはそれ以外の場所に任意の数だけ使用できます。 CLCHNAMEの長さは 48 文字に制限されています (MQ_OBJECT_NAME_LENGTH)。 チャネル名は 20 文字 (MQ_CHANNEL_NAME_LENGTH) に制限されています。 アスタリスクを指定する場合は、SHARE 属性も設定する必要があります。これにより、複数のチャネルから同時に伝送キューにアクセスできます。

[z/OS] CLCHNAME" * " を指定する場合、チャネル・プロファイル名を取得するには、チャネル・プロファイル名を引用符で囲んで指定する必要があります。 総称チャネル名を引用符で囲んで指定しなかった場合は、メッセージ CSQ9030E を受け取ります。

デフォルトのキュー・マネージャー構成では、すべてのクラスター送信側チャネルがメッセージを単一の伝送キュー SYSTEM.CLUSTER.TRANSMIT.QUEUE から送信します。 デフォルト構成は、キュー・マネージャー属性を変更することによって変更できて。DEFCLXQ 属性のデフォルト値は SCTQ です。 この値は CHANNEL に変更できます。 DEFCLXQ 属性を CHANNEL に設定すると、各クラスター送信側チャネルは、デフォルトで特定のクラスター伝送キュー SYSTEM.CLUSTER.TRANSMIT.ChannelName を使用するようになります。

[z/OS] z/OSでは、このパラメーターが設定されている場合、キューは以下のようになります。
  • 共有可能でなければならない (キュー属性 SHARE を指定)。
  • 相関 ID に索引付けされていなければならない (INDXTYPE(CORRELID) を指定)。
  • 動的キューや共有キューであってはならない。
[UNIX、Linux、Windows][z/OS]CLUSNL (名前リスト名)
そのキューが属しているクラスターのリストを指定する、NAMELISTの名 前です。

このパラメーターは、別名キュー、ローカル・キュー、およびリモート・キューでのみサポートされます。

このパラメーターの変更は、既に開いているキューの インスタンスには影響しません。

CLUSNL または CLUSTER の結果の値のうち、ブランク以外の値にできるのは片方だけです。両方に 1 つの値を指定することはできません。

ローカル・キューの場合、次のキューにはこのパラメーターは設定できません。
  • 伝送キュー
  • SYSTEM.CHANNEL.xx キュー
  • SYSTEM.CLUSTER.xx キュー
  • SYSTEM.COMMAND.xx キュー
  • [z/OS] z/OS の場合のみ、 SYSTEM.QSG.xx キュー
このパラメーターは、次のプラットフォームでのみ有効です。
  • UNIX, Linux®, and Windows
  • z/OS
[UNIX、Linux、Windows][z/OS]CLUSTER (クラスター名)
キューが属するクラスターの名前です。

このパラメーターは、別名キュー、ローカル・キュー、およびリモート・キューでのみサポートされます。

最大長は 48 文字で、 IBM MQ オブジェクトの命名規則に準拠しています。 このパラメーターの変更は、既に開いているキューの インスタンスには影響しません。

CLUSNL または CLUSTER の結果の値のうち、ブランク以外の値にできるのは片方だけです。両方に 1 つの値を指定することはできません。

ローカル・キューの場合、次のキューにはこのパラメーターは設定できません。
  • 伝送キュー
  • SYSTEM.CHANNEL.xx キュー
  • SYSTEM.CLUSTER.xx キュー
  • SYSTEM.COMMAND.xx キュー
  • [z/OS] z/OS の場合のみ、 SYSTEM.QSG.xx キュー
このパラメーターは、次のプラットフォームでのみ有効です。
  • UNIX, Linux, and Windows
  • z/OS
CLWLPRTY (整数)
クラスター・ワークロード分散のために、キューの優先順位を指定します。 このパラメーターはローカル、リモート、および別名キューにのみ有効です。 値の範囲はゼロ (最低の優先度) から 9 (最高の優先度) でなければなりません。 この属性について詳しくは、 CLWLPRTY キュー属性を参照してください。
CLWLRANK (整数)
クラスター・ワークロード分散のために、キューのランクを指定します。 このパラメーターはローカル、リモート、および別名キューにのみ有効です。 値の範囲はゼロ (最低ランク) から 9 (最高ランク) でなければなりません。 この属性について詳しくは、 CLWLRANK キュー属性を参照してください。
CLWLUSEQ
宛先キューにローカル・インスタンスと最低 1 つのリモート・クラスター・インスタンスがある場合に、MQPUT 操作の動作を指定します。 MQPUT がクラスター・チャネルから出された場合、このパラメーターの効果はありません。 このパラメーターは、ローカル・キューにのみ有効です。
QMGR
動作は、キュー・マネージャー定義のCLWLUSEQパラメーターで指定されたとおりです。
ANY
キュー・マネージャーは、ワークロードを分散するために、ローカル・キューをクラスター・キューの別のインスタンスとして処理します。
local
ローカル・キューは MQPUT 操作の唯一の宛先です。
[z/OS]の CMDSCOPE
このパラメーターは、z/OS のみに適用されます。 キュー・マネージャーがキュー共有グループのメンバーである場合の、コマンドの実行場所を指定します。
QSGDISPGROUP または SHARED に設定されている場合、CMDSCOPEはブランクまたはローカル・キュー・マネージャーでなければなりません。
''
コマンドは、コマンドが入力されたキュー・マネージャーで実行されます。
QmgrName
コマンドは、指定したキュー・マネージャーで実行されます。ただし、そのキュー・マネージャーは、キュー共有グループ内でアクティブである必要があります。

コマンドが入力されたキュー・マネージャー以外のキュー・マネージャー名を指定できます。 別の名前を指定できるのは、キュー共有グループ環境を使用しており、コマンド・サーバーが使用可能な場合に限られます。

*
コマンドはローカル・キュー・マネージャーで実行され、キュー共有グループ内のすべてのアクティブ・キュー・マネージャーにも渡されます。 * は、キュー共有グループ内のすべてのキュー・マネージャーでコマンドを入力するのと同じ結果をもたらします。
CUSTOM (ストリング)
新機能用カスタム属性。

この属性には属性の値を含めます。属性の値として、属性名と値の各ペアを 1 つ以上のスペースで分離します。 属性名と値のペアの形式は、NAME(VALUE)です。

最大長は IBM MQ 定数 MQ_CUSTOM_LENGTH によって定義され、現在はすべてのプラットフォームで 128 に設定されています。

CUSTOM 属性は、以下の IBM MQ 属性と一緒に使用することを意図しています。

CAPEXPRY (整数)
解決パスのこのオブジェクトを使用したオブジェクト・ハンドルで書き込まれたメッセージが、有効期限切れによる処理対象になるまでの最大時間 (10 分の 1 秒単位)。

メッセージの有効期限処理について詳しくは、 有効期限を強制的に短くするを参照してください。

整数
1 から 999 999 999 までの範囲の値でなければなりません。
NOLIMIT
このオブジェクトを使用して書き込まれたメッセージの有効期限時間には制限がありません。 これがデフォルト値です。
CAPEXPRYに無効な値を指定しても、コマンドが失敗することはありません。 代わりに、デフォルト値が使用されます。

CAPEXPRYでの変更より前のキュー内の既存のメッセージは、変更の影響を受けないことに注意してください (つまり、有効期限時刻は変更されません)。 CAPEXPRYでの変更後にキューに書き込まれた新規メッセージにのみ、新しい有効期限時刻が設定されます。

DEFBIND ( D)
アプリケーションが MQOPEN 呼び出しで MQOO_BIND_AS_Q_DEF を指定し、キューがクラスター・キューである場合に使用するバインディングを指定します。
open
キューのオープン時に、キュー・ハンドルがクラスター・キューの特 定のインスタンスにバインドされます。
notFixed
キュー・ハンドルは、クラスター・キューのインスタンスにバインドされません。 キュー・マネージャーは、MQPUT を使用してメッセージが書き込まれたときに特定のキュー・インスタンスを選択します。 この選択内容は、必要に応じて、後で変更されます。
GROUP
アプリケーションが、メッセージのグループが同じ宛先インスタンスに割り当てられるように要求できるようにします。

同じ名前の複数のキューをキュー・マネージャー・クラスターに公示できます。 アプリケーションは、すべてのメッセージを単一インスタンス (MQOO_BIND_ON_OPEN) に送信できます。 これにより、ワークロード管理アルゴリズムは、メッセージごとに最適な宛先 (MQOO_BIND_NOT_FIXED) を選択できます。 1 つのメッセージ・グループ全体を同じ宛先インスタンスに割り当てるようにアプリケーションから要求できます。 ワークロード・バランシングは、メッセージ・グループの中から宛先を再選択します。その場合、キューの MQCLOSE および MQOPEN は必要ありません。

MQPUT1 呼び出しは、NOTFIXED を指定した場合と同様に、常に振る舞います。

このパラメーターは、すべてのプラットフォームで有効です。

DEFPRESP (DEFPRESP)
MQPMO オプション内の書き込み応答タイプがMQPMO_RESPONSE_AS_Q_DEFに設定されている場合に、アプリケーションによって使用される動作を指定します。
同期
MQPMO_RESPONSE_AS_Q_DEFを指定したキューへの PUT 操作は、代わりにMQPMO_SYNC_RESPONSEが指定された場合と同様に発行されます。
ASYNC
MQPMO_RESPONSE_AS_Q_DEFを指定したキューへの PUT 操作は、代わりにMQPMO_ASYNC_RESPONSEが指定されている場合と同様に発行されます。MQPMO オプション (MQLONG) を参照してください。
DEFPRTY (整数)
キューに書き込まれるメッセージの、デフォルトの優先順位。 値は 0 から 9 の範囲でなければなりません。 ゼロは、MAXPRTYキュー・マネージャー・パラメーターまでの最低優先順位です。 MAXPRTYのデフォルト値は 9 です。
の DEFPSIST
アプリケーションがMQPER_PERSISTENCE_AS_Q_DEFオプションを指定するときに使用するメッセージ持続性を指定します。
NO
このキューのメッセージは、キュー・マネージャーの再始動の際に失われます。
はい
このキューのメッセージは、キュー・マネージャーの再始動の際に残されます。

[z/OS] z/OSでは、 N および YNO および YESの同義語として受け入れられます。

の DEFREADA
クライアントに配信される非持続メッセージのデフォルトの先読み動作を指定します。 先読みを有効にすると、非持続メッセージを消費するクライアント・アプリケーションのパフォーマンスを向上できます。
NO
クライアント・アプリケーションが先読みを要求するように構成されていない限り、非持続メッセージは先読みされません。
はい
非持続メッセージは、アプリケーションからの要求がある前に、クライアントに送信されます。 クライアントが異常終了した場合、またはクライアントが送信されたすべてのメッセージを削除しない場合、 非持続メッセージは失われる可能性があります。
disabled
このキューに対して、非持続メッセージの先読みは有効になりません。 クライアント・アプリケーションによって先読みが要求されているかどうかに関わりなく、メッセージはクライアントに前もって送信されません。
DEFSOPT
アプリケーションがこのキューを入力用にオープンするときの、デフォルトの共有オプション。
EXCL
オープン要求は、キューからの排他入力用です。
[z/OS] z/OSでは、 EXCL がデフォルト値です。
SHARED
オープン要求は、キューからの共用入力用です。
[UNIX、Linux、Windows、IBM i]Multiplatforms では、 SHARED がデフォルト値です。
の DEFTYPE
キュー定義タイプ。
このパラメーターは、モデル・キューでのみサポートされます。
PERMDYN
永続動的キューは、アプリケーションがオブジェクト記述子 (MQOD) で指定されたこのモデル・キューの名前を使用して MQOPEN MQI 呼び出しを発行すると作成されます。

[z/OS] z/OSでは、動的キューの属性指定は QMGRです。

[z/OS]共用 DYN
このオプションは z/OS でのみ使用可能です。

永続動的キューは、アプリケーションがオブジェクト記述子 (MQOD) に指定されたこのモデル・キューの名前を使用して MQOPEN API 呼び出しを発行すると作成されます。

動的キューの属性指定は SHARED です。

TEMPDYN
一時動的キューは、アプリケーションがオブジェクト記述子 (MQOD) に指定されたこのモデル・キューの名前を使用して MQOPEN API 呼び出しを発行すると作成されます。

[z/OS] z/OSでは、動的キューの属性指定は QMGRです。

DEFPSISTパラメーターが YES のモデル・キュー定義には、この値を指定しないでください。

このオプションを指定する場合は、INDXTYPE(MSGTOKEN) を指定しないでください。

DESCR (ストリング)
平文コメント。 オペレーターが DISPLAY QUEUE コマンドを実行したときに表示される、このオブジェクトについての記述情報です。

表示可能文字だけを含めることができます。 最大長は 64 文字です。 DBCS のインストール済み環境では、この値に DBCS 文字 (最大長 64 バイト) を使用できます。

注: このキュー・マネージャーのコード化文字セット ID (CCSID) に含まれる文字を使用してください。 それ以外の文字を使用し、情報が別のキュー・マネージャーに送信された場合には、正しく変換されないことがあります。
[UNIX、Linux、Windows]DISTL (DISTL)
パートナー・キュー・マネージャーが配布リストをサポートするかどうかを設定します。
はい
配布リストは、パートナー・キュー・マネージャーによってサポート されます。
NO
配布リストは、パートナー・キュー・マネージャーによってサポート されません。
注: このパラメーターは MCA によって設定されるため、通常は変更しません。 ただし、宛先キュー・マネージャーの配布先リスト機能が確認されている場合は、伝送キューの定義時にこのパラメーターを設定できます。

このパラメーターは、 UNIX, Linux, and Windowsでのみ有効です。

強制 ( FORCE)
このパラメーターは、別名キュー、ローカル・キュー、およびリモート・キュー上で ALTER コマンドのみに適用されます。

このパラメーターを指定すると、次のような状況でコマンドを強制的に終了します。

別名キューでは、次の記述が共に真である場合が該当します。
  • TARGET パラメーターは、キューを指定します。
  • この別名キューをオープンしているアプリケーションがある。
ローカル・キューでは、次の記述が共に真である場合が該当します。
  • NOSHAREパラメーターが指定されている
  • 複数のアプリケーションがそのキューを入力用にオープンしている。
FORCEは、以下の記述が両方とも真である場合にも必要です。
  • USAGEパラメーターが変更されました。
  • そのキュー上に 1 つ以上のメッセージがあるか、1 つ以上のアプリケーションがそのキューをオープンしている。

キューにメッセージがある間は、USAGEパラメーターを変更しないでください。メッセージが伝送キューに書き込まれると、メッセージの形式が変更されます。

リモート・キューでは、次の記述が共に真である場合が該当します。
  • XMITQパラメーターが変更されました。
  • このキューをリモート・キューとしてオープンしているアプリケーションが、1 つ以上ある。
FORCEは、以下の記述が両方とも真である場合にも必要です。
  • RNAMERQMNAME、またはXMITQパラメーターのいずれかが変更される
  • この定義を通じてキュー・マネージャーの別名を解決するアプリケーションの中に、キューをオープンしているものが 1 つ以上ある。
注: この定義が応答先キュー別名としてのみ使用されている場合は、 FORCE は必要ありません。

説明されている状況でFORCEが指定されていない場合、コマンドは失敗します。

取得 ( GET)
アプリケーションが、このキューからのメッセージの取得を許可されるかどうかを指定します。
有効
適切に許可されたアプリケーションが、キューからメッセージを取り出すことができます。
disabled
アプリケーションはキューからメッセージを検索できません。

このパラメーターは、MQSET API 呼び出しを使用して変更することもできます。

HARDENBO & NOHARDENBO
メッセージがバックアウトされた回数のカウントのハード化を行うかどうかを指定します。 カウントが固定されると、MQGET 操作によってメッセージが戻される前に、メッセージ記述子のBackoutCountフィールドの値がログに書き込まれます。 値をログに書き込むことにより、キュー・マネージャーの再始動の際に確実に正確な値にできます。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

バックアウト・カウントがハード化されている場合、このキューの持続メッセージの MQGET 操作のパフォーマンスは影響を受けます。

HARDENBO
このキューのメッセージのメッセージ・バックアウト・カウントは、カウントを正確にするためにハード化されます。
バックアウト強化なし
このキューのメッセージのメッセージ・バックアウト・カウントはハード化されず、キュー・マネージャーの再始動後も正確でない可能性があります。
[z/OS]注: このパラメーターは IBM MQ for z/OSにのみ影響します。 Multiplatforms では、このパラメーターは設定可能ですが、無効です。
[V9.1.0 2018 年 7 月][UNIX、Linux、Windows、IBM i]IMGRCOVQ (IMGRCOVQ)
リニア・ロギングを使用する場合に、ローカル動的キュー・オブジェクトまたは永続動的キュー・オブジェクトをメディア・イメージからリカバリー可能にするかどうかを指定します。 指定可能な値は以下のとおりです。
YES
これらのキュー・オブジェクトはリカバリー可能です。
NO
rcdmqimg (レコード・メディア・イメージ) およびrcrmqobj (オブジェクトの再作成) コマンドは、これらのオブジェクトに対しては許可されず、これらのオブジェクトに対して自動メディア・イメージ (使用可能な場合) は書き込まれません。
QMGR
キュー・マネージャーを指定し、キュー・マネージャーのIMGRCOVQ属性に YES を指定した場合、これらのキュー・オブジェクトはリカバリー可能です。

QMGR を指定し、キュー・マネージャーの IMGRCOVQ 属性が NOを指定した場合、 rcdmqimg (メディア・イメージの記録) およびrcrmqobj (オブジェクトの再作成) コマンドはこれらのオブジェクトに対して許可されず、使用可能になっている場合、自動メディア・イメージはこれらのオブジェクトに対して書き込まれません。

QMGR がデフォルト値です。

このパラメーターは、z/OS では無効です。

[z/OS]の INDXTYPE
キューの MQGET 操作を円滑に行うためにキュー・マネージャーによって保持される索引のタイプ。 共用キューの場合は、索引のタイプにより、使用可能な MQGET 操作のタイプが決まります。

このパラメーターは、z/OS でのみサポートされます。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

以下の表に示すような適切な索引タイプが維持されている場合のみ、選択基準を使用してメッセージを取得することができます。

表 2. 異なる検索選択基準のために必要な索引タイプ
検索選択基準 必要な索引タイプ
  共用キュー その他のキュー
なし (順次検索) 任意 任意
メッセージ ID MSGID または NONE 任意
相関 ID CORRELID 任意
メッセージ ID と相関 ID MSGID または CORRELID 任意
グループ ID GROUPID 任意
グループ化 GROUPID GROUPID
メッセージ・トークン Not allowed MSGTOKEN
ここで、INDXTYPEパラメーターの値は、以下の値になります。
NONE
索引を維持しません。 通常、メッセージが順次検索される場合に、NONE を使用するか、または MQGET 呼び出しの選択基準としてメッセージ ID と相関 ID の両方を使用します。
MSGID
メッセージ ID の索引は保持されます。 MSGID は、通常、MQGET 呼び出しの選択基準としてメッセージ ID を使用し、相関 ID を NULL に設定してメッセージを検索する場合に使用します。
CORRELID
相関 ID の索引は保持されます。 CORRELID は、通常、MQGET 呼び出しの選択基準として相関 ID を使用し、メッセージ ID を NULL に設定してメッセージを検索する場合に使用します。
GROUPID
グループ ID の索引は保持されます。 GROUPID は、メッセージ・グループ選択基準を使用してメッセージを検索する場合に使用します。
注:
  1. キューが伝送キューの場合、INDXTYPEGROUPID に設定することはできません。
  2. キューは CFLEVEL(3)の CF 構造体を使用して、INDXTYPE(グループ ID) で共有キューを指定する必要があります。
[z/OS] MSGTOKEN
メッセージ・トークンの索引は保持されます。 MSGTOKEN は、キューが、 z/OSのワークロード・マネージャー機能で使用する WLM 管理キューである場合に使用します。
注: 以下の場合、 INDXTYPEMSGTOKEN に設定することはできません。
  • キューが定義タイプ SHAREDYN のモデル・キューである
  • キューが一時動的キューである
  • キューが伝送キューである
  • QSGDISP(SHARED) を指定する

共有されておらず、グループ化またはメッセージ・トークンを使用しないキューでは、検索選択タイプは索引タイプによって制限されません。 ただし、索引はキューでのGET操作を迅速化するために使用されるため、最も一般的な検索選択に対応するタイプを選択してください。

既存のローカル・キューを変更または置換する場合、INDXTYPEパラメーターを変更できるのは、以下の表に示す場合のみです。
表 3. 索引タイプの変更が許可されるかどうかはキューの共有およびキュー内のメッセージの有無による
キュー・タイプ 非共有 SHARED
キューの状態 コミットされていないアクティビティー コミットされていないアクティビティーはなく、メッセージが存在する コミットされていないアクティビティーはなく、空である オープンしているか、またはメッセージが存在する オープンしておらず、空である
INDXTYPEを以下のものから変更します。 変換後: 変更の可否
NONE MSGID いいえ はい はい いいえ はい
NONE CORRELID いいえ はい はい いいえ はい
NONE MSGTOKEN いいえ いいえ はい - -
NONE GROUPID いいえ いいえ はい いいえ はい
MSGID NONE いいえ はい はい いいえ はい
MSGID CORRELID いいえ はい はい いいえ はい
MSGID MSGTOKEN いいえ いいえ はい - -
MSGID GROUPID いいえ いいえ はい いいえ はい
CORRELID NONE いいえ はい はい いいえ はい
CORRELID MSGID いいえ はい はい いいえ はい
CORRELID MSGTOKEN いいえ いいえ はい - -
CORRELID GROUPID いいえ いいえ はい いいえ はい
MSGTOKEN NONE いいえ はい はい - -
MSGTOKEN MSGID いいえ はい はい - -
MSGTOKEN CORRELID いいえ はい はい - -
MSGTOKEN GROUPID いいえ いいえ はい - -
GROUPID NONE いいえ いいえ はい いいえ はい
GROUPID MSGID いいえ いいえ はい いいえ はい
GROUPID CORRELID いいえ いいえ はい いいえ はい
GROUPID MSGTOKEN いいえ いいえ はい - -
INITQ (ストリング)
このキュー・マネージャーにおける、開始キューのローカル名。 この開始キューには、このキューに関係するトリガー・メッセージが書き込まれます。IBM MQ オブジェクトの命名規則を参照してください。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

LIKE (qtype-name)
キューの名前。このキューのパラメーターが、この定義のモデルとして使用されます。

このフィールドに値が入力されていない場合、未定義のパラメーター・フィールドの値は以下のいずれかの定義から取得されます。 選択項目はキュー・タイプによって異なります。

表 4。 キューのタイプおよび各タイプに対応する定義
キュー・タイプ 定義
別名キュー SYSTEM.DEFAULT.ALIAS.QUEUE
ローカル・キュー SYSTEM.DEFAULT.LOCAL.QUEUE
モデル・キュー SYSTEM.DEFAULT.MODEL.QUEUE
リモート・キュー SYSTEM.DEFAULT.REMOTE.QUEUE
例えば、このパラメーターを指定しないことは、別名キューに対して以下のLIKEの値を定義することと同等です。

LIKE(SYSTEM.DEFAULT.ALIAS.QUEUE)

すべてのキューに異なるデフォルト定義が必要な場合は、LIKEパラメーターを使用する代わりに、デフォルトのキュー定義を変更してください。

[z/OS] z/OSでは、キュー・マネージャーは、 QMGRCOPY、または SHAREDの属性指定で指定された名前とキュー・タイプを持つオブジェクトを検索します。 LIKE オブジェクトの属性指定は、定義しているオブジェクトにはコピーされません。
注:
  1. QSGDISP(GROUP) オブジェクトは検索されません。
  2. QSGDISP(COPY) が指定されている場合、LIKEは無視されます。
[UNIX、Linux、Windows][z/OS]MAXDEPTH (整数)
キューに書き込めるメッセージの最大数。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

次のプラットフォームでは、0 から 999999999 までの範囲の値を指定します。
  • [UNIX、Linux、Windows]UNIX, Linux, and Windows
  • [z/OS]z/OS
その他の IBM MQ プラットフォームでは、0 から 640000 の範囲の値を指定します。

他の要因によって、キューが引き続きフルと見なされることがあります。例えば、使用できるハード・ディスク・スペースがない場合などです。

この値を小さくした場合、既にキュー上にあるメッセージで、この新しい最大数を超えるメッセージがあってもそれはそのまま保持されます。

[V9.1.5 2020 年 4 月][UNIX、Linux、Windows、IBM i]の MAXFSIZE
キュー・ファイルを拡張できる最大サイズ (メガバイト単位)。 この値を現在のキュー・ファイル・サイズより小さい値に構成している場合、キュー・ファイルのサイズがこのサイズを超える可能性があります。
その場合、キュー・ファイルは新しいメッセージを受け入れなくなりますが、既存のメッセージはコンシュームできます。 キュー・ファイル・サイズを構成済みの値より小さくすると、新しいメッセージをキューに書き出すことができます。
注: この図は、キューに構成されている属性の値とは異なる場合があります。これは、キュー・マネージャーが選択されたサイズに達するために、内部的により大きなブロック・サイズを使用する必要がある場合があるためです。 キュー・ファイルのサイズ、ブロック・サイズ、および細分度の変更について詳しくは、 IBM MQ キュー・ファイルの変更 を参照してください。
この属性が増加したために細分度を変更する必要がある場合は、警告メッセージ AMQ7493WGranularity changedAMQERR ログに書き込まれます。 これは、 IBM MQ が新しい細分度を採用するために、キューを空にするように計画する必要があることを示します。
20 以上、かつ 267,386,880 以下の値を指定してください。

この属性のデフォルト値は DEFAULTです。これは、 IBM MQ 9.1.5より前のバージョンの IBM MQ のキューの最大値である 2,088,960 MB のハードコーディング値に相当します。

MAXMSGL (整数)
このキューにおけるメッセージの最大長 (バイト)。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

[UNIX、Linux、Windows] UNIX, Linux, and Windowsでは、ゼロからキュー・マネージャーの最大メッセージ長までの範囲の値を指定します。 ALTER QMGR コマンドの MAXMSGL パラメーター、 ALTER QMGR MAXMSGLを参照してください。

[z/OS] z/OSでは、0 から 100 MB (104 857 600 バイト) の範囲の値を指定します。

メッセージ長には、ユーザー・データの長さと、ヘッダーの長さが含まれます。 伝送キューに入れられるメッセージには、伝送ヘッダーが追加されます。 メッセージ・ヘッダー全体として、追加の 4000 バイトを考慮してください。

この値を小さくしたために、既にキュー上にあるメッセージの長さが新しい最大数を超過しても、そのメッセージには影響がありません。

アプリケーションはこのパラメーターを使用して、キューからメッセージを取得するためのバッファーのサイズを決定できます。 したがって、この値を減らすことができるのは、アプリケーションが誤動作しないとわかっている場合のみです。

メッセージにデジタル署名と鍵を追加することにより、 Advanced Message Security ではメッセージの長さが増すことに注意してください。

キューに関するオンライン・モニター・データの収集を制御します。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

QMGR
キュー・マネージャー・パラメーターMONQの設定に従って、モニター・データを収集します。
オフ
このキューのオンライン・モニター・データ収集はオフになります。
低い
キュー・マネージャーのMONQパラメーターの値が NONE でない場合、このキューのオンライン・モニター・データ収集はオンになります。
中間
キュー・マネージャーのMONQパラメーターの値が NONE でない場合、このキューのオンライン・モニター・データ収集はオンになります。
高い
キュー・マネージャーのMONQパラメーターの値が NONE でない場合、このキューのオンライン・モニター・データ収集はオンになります。
LOWMEDIUM、 および HIGH のどの値を指定しても違いがないことに注意してください。 これらの値はすべて、データ収集をオンにしますが、 収集の比率には影響しません。

このパラメーターを ALTER キュー・コマンドで使用した場合、変更はキューが次にオープンされたときに有効になります。

MSGDLVSQ (MSGDLVSQ)
メッセージ・デリバリー・シーケンス。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

priority
MQGET API 呼び出しによるメッセージの配布は、優先順位内の先入れ先出し (FIFO) 順序で行われます。
FIFO
MQGET API 呼び出しによるメッセージの配布は、FIFO 順で行われます。 このキューのメッセージについては、優先順位が無視されます。

メッセージ・デリバリー・シーケンス・パラメーターは、キューにメッセージがあるときに、PRIORITY から FIFO に変更できます。 既にキューにあるメッセージの順序は変更されません。 変更後にキューに追加されたメッセージには、そのキューのデフォルトの優先順位が適用されます。したがって、既存のメッセージより先に処理されるものもあります。

メッセージ・デリバリー・シーケンスを FIFO から PRIORITY に変更した場合は、キューの設定が FIFO であったときにキューに書き込まれたメッセージにはデフォルトの優先順位が適用されます。

[z/OS]注: INDXTYPE(GROUPID) に MSGDLVSQ(PRIORITY) が指定されている場合、グループが取得される優先順位は、各グループ内の最初のメッセージの優先順位に基づきます。 優先順位 0 と 1 は、キュー・マネージャーによって、論理順序でのメッセージの検索を最適化するために使用されます。 各グループ内の最初のメッセージには、これらの優先順位を使用しないでください。 使用すると、メッセージは優先順位 2 であるかのように保管されます。
[UNIX、Linux、Windows、IBM i]NPMCLASS (NPMCLASS)
キューに書き込まれる非持続メッセージに割り当てる信頼性のレベル。
正規 (Normal)
非持続メッセージは、障害が発生したり、キュー・マネージャーがシャットダウンしたりすると失われます。 これらのメッセージは、キュー・マネージャーの再起動で廃棄されます。
高い
キュー・マネージャーは、キュー・マネージャーの再始動または切り替えの間、このキューで非持続メッセージを保持しようとします。

[z/OS]このパラメーターは、 z/OSでは設定できません。

PROCESS (ストリング)
IBM MQ プロセスのローカル名です。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

このパラメーターは、トリガー・イベントが起こったときキュー・マネージャー によって開始されるアプリケーションを示す、プロセス・インスタンスの 名前です。IBM MQ オブジェクトの命名規則を参照してください。

プロセス定義は、ローカル・キューが定義されている場合は確認されませんが、トリガー・イベントを発生させるには使用可能でなければなりません。

キューが伝送キューである場合、プロセス定義には開始されるチャネルの名前が含まれています。 このパラメーターは、次のプラットフォームの伝送キューのためのオプションです。
  • [IBM i]IBM i
  • [UNIX、Linux、Windows]UNIX, Linux, and Windows
  • [z/OS]z/OS
これを指定しない場合、チャネル名はTRIGDATAパラメーターに指定された値から取られます。
PROPCTL
プロパティー制御属性。 この属性はオプションです。 ローカル・キュー、別名キュー、およびモデル・キューに適用されます。
注: アプリケーションが別名キューをオープンする場合は、別名キューとターゲット・キューの両方にこの値を設定する必要があります。
PROPCTLオプションは以下のとおりです。 これらのオプションは、MQMDまたはMQMD拡張のメッセージ・プロパティーには影響しません。
ALL

アプリケーションがメッセージのすべてのプロパティーをMQRFH2ヘッダーで読み取るか、またはメッセージ・ハンドルのプロパティーとして読み取ることができるように、ALL を設定します。

ALL オプションは、変更できないアプリケーションが MQRFH2 ヘッダーからすべてのメッセージ・プロパティーにアクセスできるようにします。 変更可能なアプリケーションは、メッセージ・ハンドルのプロパティーとして、すべてのメッセージ・プロパティーにアクセスできます。

場合によっては、受信したメッセージのMQRFH2ヘッダーのデータ形式が、送信時のメッセージの形式と異なることがあります。

COMPAT

COMPAT を設定すると、JMS関連のプロパティーがメッセージ・データのMQRFH2ヘッダーにあることを予期する未変更のアプリケーションは、以前と同様に動作します。 変更可能なアプリケーションは、メッセージ・ハンドルのプロパティーとして、すべてのメッセージ・プロパティーにアクセスできます。

メッセージに mcd.jms.usr.、または mqext. という接頭部を持つプロパティーがある場合、すべてのメッセージ・プロパティーはアプリケーションに送達されます。 メッセージ・ハンドルが指定されていない場合、プロパティーはMQRFH2ヘッダーで返されます。 メッセージ・ハンドルが指定されている場合は、すべてのプロパティーがメッセージ・ハンドルに返されます。

メッセージにいずれかの接頭部があるプロパティーが含まれておらず、アプリケーションでメッセージ・ハンドルが指定されていない場合、メッセージ・プロパティーはアプリケーションに返されません。 メッセージ・ハンドルが指定されている場合は、すべてのプロパティーがメッセージ・ハンドルに返されます。

場合によっては、受信したメッセージのMQRFH2ヘッダーのデータ形式が、送信時のメッセージの形式と異なることがあります。

FORCE

すべてのアプリケーションがMQRFH2ヘッダーからメッセージ・プロパティーを読み取るように強制します。

アプリケーションがメッセージ・ハンドルを指定しているかどうかに関係なく、プロパティーは常にMQRFH2ヘッダーのメッセージ・データで返されます。

MQGET 呼び出しの MQGMO 構造体の MsgHandle フィールドに指定された有効なメッセージ・ハンドルは無視されます。 メッセージのプロパティーにメッセージ・ハンドルを使用してアクセスすることはできません。

場合によっては、受信したメッセージのMQRFH2ヘッダーのデータ形式が、送信時のメッセージの形式と異なることがあります。

NONE

メッセージ・ハンドルが指定されている場合は、すべてのプロパティーがメッセージ・ハンドルに返されます。

すべてのメッセージ・プロパティーは、アプリケーションに送信される前にメッセージ本文から削除されます。

PUT (PUT)
メッセージをキューに書き込むことができるかどうかを指定します。
有効
キューにメッセージを追加できます (追加できるのは所定の許可を持つアプリケーション)。
disabled
メッセージをキューに追加することはできません。

このパラメーターは、MQSET API 呼び出しを使用して変更することもできます。

QDEPTHHI (整数)
キュー・サイズ上限イベントを生成する際にキューの長さの比較の対象になるしきい値。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

[z/OS] z/OS 上の共用キューがこのイベントに与える影響について詳しくは、 z/OS上の共用キューおよびキュー・サイズ・イベントを参照してください。

このイベントは、アプリケーションがキューにメッセージを書き込んだ結果、キュー上のメッセージ数がキュー・サイズ上限しきい値以上になったことを示しています。 QDPHIEVパラメーターを参照してください。

値は、最大キュー項目数 (MAXDEPTH パラメーター) に対するパーセンテージで表され、0 から 100 までの範囲で、QDEPTHLO以上でなければなりません。

QDEPTHLO (整数)
キュー・サイズ下限イベントを生成する際にキューの長さの比較の対象になるしきい値。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

[z/OS] z/OS 上の共用キューがこのイベントに与える影響について詳しくは、 z/OS上の共用キューおよびキュー・サイズ・イベントを参照してください。

このイベントは、アプリケーションがメッセージをキューから取り出した結果、キュー上のメッセージ数がキュー・サイズ下限しきい値以下になったことを示しています。 QDPLOEVパラメーターを参照してください。

この値は、最大キュー項目数 (MAXDEPTH パラメーター) に対するパーセンテージで表されます。この値は、0 から 100 までの範囲で、QDEPTHHI以下でなければなりません。

QDPHIEV (QDPHIEV)
キュー・サイズ上限イベントを生成するかどうかを制御します。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

キュー・サイズ上限イベントは、アプリケーションがキューにメッセージを書き込んだ結果、キュー上のメッセージ数がキュー・サイズ上限しきい値以上になったことを示しています。 QDEPTHHIパラメーターを参照してください。
有効
「キュー項目数高」イベントが生成されます。
disabled
「キュー項目数高」イベントは生成されません。
注: このパラメーターの値は、暗黙的に変更されることがあります。

[z/OS] z/OSでは、共用キューがイベントに影響します。

このイベントについて詳しくは、 キュー・サイズ上限を参照してください。

QDPLOEV (QDPLOEV)
キュー・サイズ下限イベントを生成するかどうかを制御します。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

キュー・サイズ下限イベントは、アプリケーションがメッセージをキューから取り出した結果、キュー上のメッセージ数がキュー・サイズ下限しきい値以下になったことを示しています。 QDEPTHLOパラメーターを参照してください。
有効
「キュー項目数低」イベントが生成されます。
disabled
「キュー項目数低」イベントは生成されません。
注: このパラメーターの値は、暗黙的に変更されることがあります。

[z/OS] z/OSでは、共用キューがイベントに影響します。

このイベントについて詳しくは、 キュー・サイズ下限を参照してください。

QDPMAXEV
キュー満杯イベントを生成するかどうかを制御します。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

キュー・フル・イベントは、キューがいっぱいであるために、キューへの書き込みが拒否されたことを示しています。 キュー・サイズは最大値に達しています。
有効
「キュー・フル」イベントが生成されます。
disabled
「キュー・フル」イベントは生成されません。
注: このパラメーターの値は、暗黙的に変更されることがあります。

[z/OS] z/OSでは、共用キューがイベントに影響します。

このイベントについて詳しくは、 キュー・フルを参照してください。

[z/OS] 「QSGDISP」
このパラメーターは、z/OS のみに適用されます。

グループ内のオブジェクトの処理を指定します。

表 5. QSGDISP オプションのオブジェクト属性指定
QSGDISP DEFINE
COPY オブジェクトは、LIKE オブジェクトと同じ名前の QSGDISP(GROUP) オブジェクトを使用してコマンドを実行するキュー・マネージャーのページ・セットで定義されています。

ローカル・キューの場合、メッセージは各キュー・マネージャーのページ・セットに保管され、そのキュー・マネージャーを介してのみ使用できます。

GROUP オブジェクト定義が共有リポジトリーに常駐しています。これは、共有キュー・マネージャー環境が存在する場合にのみ有効です。 定義が正常に実行されると、以下のコマンドが生成されます。 コマンドは、すべてのアクティブなキュー・マネージャーに送信されて、ページ・セット 0 上でローカル・コピーの作成またはリフレッシュが試行されます。

DEFINE QUEUE(q-name)
REPLACE QSGDISP(COPY)
グループ・オブジェクトに対する DEFINE コマンドは、 QSGDISP(COPY) で生成されたコマンドが失敗したかどうかに関係なく有効になります。
PRIVATE 許可されません。
QMGR オブジェクトは、コマンドを実行するキュー・マネージャーのページ・セットで定義されます。 ローカル・キューの場合、メッセージは各キュー・マネージャーのページ・セットに保管され、そのキュー・マネージャーを介してのみ使用できます。
SHARED このオプションは、ローカル・キューにのみ適用されます。 オブジェクトは共有リポジトリーで定義されます。 メッセージはカップリング・ファシリティーに保管されるので、キュー共有グループ内のすべてのキュー・マネージャーで使用できます。 SHARED を使用できるのは次の場合だけです。
  • CFSTRUCT がブランクではない
  • INDXTYPEMSGTOKEN ではない
  • 以下のキューではない:
    • SYSTEM.CHANNEL.INITQ
    • SYSTEM.COMMAND.INPUT
キューがクラスター化されると、コマンドが生成されます。 このコマンドがキュー共有グループ内でアクティブなキュー・マネージャーすべてに送信され、このクラスター化された共有キューについての通知が行われます。
QSVCIEV (QSVCIEV)
サービス間隔上限イベントまたはサービス間隔 OK イベントを生成するかどうかを制御します。

このパラメーターは、ローカル・キューおよびモデル・キューでのみサポートされ、共有キューで指定された場合は無効です。

サービス間隔上限イベントは、QSVCINTパラメーターで指定された時間以上、キューからメッセージが取得されなかったことが検査で示された場合に生成されます。

サービス間隔 OK イベントは、QSVCINTパラメーターで指定された時間内にキューからメッセージが取得されたことが検査で示された場合に生成されます。

注: このパラメーターの値は、暗黙的に変更されることがあります。 詳しくは、「 キュー・サービス間隔上限 」および「 キュー・サービス間隔 OK」のサービス間隔上限イベントおよびサービス間隔 OK イベントの説明を参照してください。
高い
サービス間隔高イベントが生成されます。
OK
サービス間隔 OK イベントが生成されます。
NONE
サービス間隔イベントは生成されません。
QSVCINT (整数)
サービス間隔上限およびサービス間隔 OK イベントを生成する際に、比較に使用されるサービス間隔。

このパラメーターは、ローカル・キューおよびモデル・キューでのみサポートされ、共有キューで指定された場合は無効です。

QSVCIEVパラメーターを参照してください。

値はミリ秒単位で、0 から 999999999 の範囲内でなければなりません。

置換 & NOREPLACE
このオプションは、既存の定義をこの定義に置き換えるかどうかを制御します。
[z/OS]注: IBM MQ for z/OSでは、既存の定義は、後処理が同じ場合にのみ置き換えられます。 属性指定が異なるオブジェクトは変更されません。
REPLACE
オブジェクトが存在している場合の結果は、ALTER コマンドに FORCE パラメーターを除くすべてのパラメーターを指定して実行した場合と似ています。 特に、既存のキューにあるメッセージはすべて保存されるのでご注意ください。

FORCE パラメーターを指定しない ALTER コマンドと、 REPLACE パラメーターを指定した DEFINE コマンドの間には違いがあります。 違いは、 ALTER は指定されていないパラメーターを変更しませんが、 REPLACE を指定した DEFINE はすべてのパラメーターを設定します。 REPLACE を使用すると、 指定されていないパラメーターは LIKE パラメーターに指定されたオブジェクトまたはデフォルト定義から取得され、置換対象のオブジェクトのパラメーターがあってもそれは無視されます。

次の記述が共に真である場合、コマンドは失敗します。
  • このコマンドは、 ALTER コマンドを使用する場合に FORCE パラメーターを使用する必要があるパラメーターを設定します。
  • そのオブジェクトがオープンされている

このような状況では、ALTER コマンドに FORCE パラメーターを指定するとうまくいきます。

[UNIX、Linux、Windows] UNIXLinux、または WindowsSCOPE(CELL) が指定され、セル・ディレクトリーに同じ名前のキューが既に存在する場合、 REPLACE が指定されていてもコマンドは失敗します。

NOREPLACE
定義はオブジェクトのどの既存の定義も置き換えません。
RETINTVL (整数)
キューが定義されたときからの時間数。その時間が経過すれば、そのキューは不要となります。 値は 0 から 999,999,999 の範囲でなければなりません。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

CRDATE および CRTIME は、 DISPLAY QUEUE コマンドを使用して表示できます。

オペレーターとハウスキーピング・アプリケーションは、この情報に基づいて、不要になったキューを削除できます。

注: キュー・マネージャーは、この値に基づいてキューを削除することも、保存間隔が満了していないキューの削除を防止することもしません。 必要なアクションは、ユーザーの責任で行ってください。
RNAME (ストリング)
リモート・キューの名前。 このパラメーターは、RQMNAMEで指定されたキュー・マネージャーで定義されたキューのローカル名です。
このパラメーターは、リモート・キューでのみサポートされます。
  • この定義がリモート・キューのローカル定義に使用される場合、オープン時にRNAMEがブランクであってはなりません。
  • この定義がキュー・マネージャー別名定義に使用される場合、オープン時にRNAMEはブランクでなければなりません。

    キュー・マネージャー・クラスターでは、この定義はこのクラスターを作成したキュー・マネージャーのみに適用されます。 クラスター全体に別名を通知するには、リモート・キュー定義にCLUSTER属性を追加します。

  • この定義が応答先キュー別名に使用される場合、この名前は、応答先キューとなるキューの名前です。
通常、キュー名に許可されている文字には制限がありますが、その検査は行われません。IBM MQ オブジェクトの命名規則を参照してください。
RQMNAME (ストリング)
キューRNAMEが定義されているリモート・キュー・マネージャーの名前。
このパラメーターは、リモート・キューでのみサポートされます。
  • アプリケーションがリモート・キューのローカル定義をオープンする場合、RQMNAMEはブランクまたはローカル・キュー・マネージャーの名前であってはなりません。 オープン時に、XMITQがブランクの場合は、伝送キューとして使用されるこの名前のローカル・キューがなければなりません。
  • この定義がキュー・マネージャー別名に使用される場合、RQMNAMEは別名が割り当てられるキュー・マネージャーの名前です。 これは、ローカル・キュー・マネージャーの名前であっても構いません。 あるいは、XMITQがブランクの場合、オープンが行われるときに、伝送キューとして使用されるこの名前のローカル・キューが存在している必要があります。
  • 応答先 (reply-to) キュー別名にRQMNAMEを使用する場合、 RQMNAME は、応答先 (reply-to) キュー・マネージャーにするキュー・マネージャーの名前です。
通常、IBM MQ オブジェクト名に許可されている文字には制限がありますが、その検査は行われません。IBM MQ オブジェクトの命名規則を参照してください。
[UNIX、Linux、Windows]有効範囲
キュー定義の有効範囲を指定します。
このパラメーターは、別名キュー、ローカル・キュー、およびリモート・キューでのみサポートされます。
QMGR
キュー定義の有効範囲は、キュー・マネージャー内です。 キューを所有するキュー・マネージャー以外では、キュー定義は適用しません。 別のキュー・マネージャーが所有する出力のキューを、次の 2 つの方法のいずれかで開くことができます。
  1. 所有キュー・マネージャーの名前を指定します。
  2. 他方のキュー・マネージャーにあるキューのローカル定義を開きます。
CELL
キュー定義の有効範囲は、セルになります。 セルの有効範囲とは、キューがそのセル内のすべてのキュー・マネージャーに認識されていることを意味します。 セルの有効範囲が指定されたキューは、キューの名前を指定するだけで、出力用に開くことができます。 キューを所有するキュー・マネージャーの名前を指定する必要はありません。

同じ名前を持つキューが既にセル・ディレクトリーにある場合、コマンドは失敗します。 REPLACEオプションは、この状態には影響しません。

値は、セル・ディレクトリーをサポートする名前サービスが構成されている場合にのみ有効です。
制約事項: DCE ネーム・サービスはサポートされなくなりました。

このパラメーターは、 UNIX, Linux, and Windowsでのみ有効です。

SHARE および NOSHARE
複数のアプリケーションがこのキューからメッセージを検索できるかどうかを指定します。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
SHARE
複数のアプリケーション・インスタンスがこのキューからメッセージを読み取ることができます。
非共有
1 つのアプリケーション・インスタンスのみがこのキューからメッセージを読み取ることができます。
[UNIX、Linux、Windows、IBM i]状況
統計データ収集を有効にするかどうかを指定します。
QMGR
統計データ収集は、キュー・マネージャーのSTATQパラメーターの設定に基づきます。
ON
キュー・マネージャーのSTATQパラメーターの値が NONE でない場合、キューの統計データ収集は有効になります。
オフ
キューの統計データ収集は使用不可になります。

このパラメーターを ALTER キュー・コマンドで使用した場合、変更は、パラメーターの変更後に作成された、キュー・マネージャーへの接続に対してのみ有効になります。

このパラメーターは、 Multiplatformsでのみ有効です。

[z/OS]STGCLASS (ストリング)
ストレージ・クラスの名前。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

注: このパラメーターを変更できるのは、キューが空でクローズされている場合のみです。

このパラメーターはインストール時に定義した名前です。 名前の 1 番目の文字は英大文字 A から Z、2 番目の文字以降は英大文字の A から Z か数字の 0 から 9 でなければなりません。

このパラメーターは z/OS でのみ有効です。ストレージ・クラスを参照してください。

TARGET (ストリング)
別名として使用するキューまたはトピック・オブジェクトの名前。IBM MQ オブジェクトの命名規則を参照してください。 オブジェクトは、TARGTYPEによって定義されたキューまたはトピックにすることができます。 最大長は 48 文字です。

このパラメーターは、別名キューでのみサポートされます。

このオブジェクトは、アプリケーション・プロセスが別名キューをオープンするときにのみ定義する必要があります。

IBM WebSphere® MQ 6.0で定義されている TARGQ パラメーターは、バージョン 7.0 から TARGET に名前変更され、キューまたはトピックのいずれかの名前を指定できるように汎用化されました。 TARGET のデフォルト値はキューであるため、 TARGET(my_queue_name)TARGQ(my_queue_name)と同じになります。 TARGQ 属性は、既存のプログラムとの互換性のために保持されています。 TARGET を指定する場合、同時に TARGQ を指定することはできません。
TARGTYPE (ストリング)
別名の解決先のオブジェクトのタイプ。
QUEUE
別名はキューに解決されます。
トピック
別名はトピックに解決されます。

TRIGDATA (ストリング)
トリガー・メッセージに挿入されるデータ。 ストリングの最大長は 64 バイトです。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

伝送キューの場合には、このパラメーターを使用して、開始するチャネルの名前を指定することができます。

このパラメーターは、MQSET API 呼び出しを使用して変更することもできます。

TRIGDPTH (整数)
TRIGTYPEDEPTHの場合、トリガー・メッセージが書き込まれる前にキューに入っていなければならないメッセージの数。 値は 1 から 999,999,999 の範囲でなければなりません。 デフォルト値は1です。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

このパラメーターは、MQSET API 呼び出しを使用して変更することもできます。

トリガー & NOTRIGGER
PROCESSパラメーターで指定されたアプリケーションをトリガーするために、INITQパラメーターで指定された開始キューにトリガー・メッセージを書き込むかどうかを指定します。
TRIGGER
トリガー操作をアクティブにすると、トリガー・メッセージが開始キューに書き込まれます。
NOTRIGGER
トリガー操作をアクティブにしないと、トリガー・メッセージは開始キューに書き込まれません。 これがデフォルト値です。

このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。

このパラメーターは、MQSET API 呼び出しを使用して変更することもできます。

TRIGMPRI (整数)
このキューでのトリガーとなるメッセージ優先順位番号。 値は、ゼロから MAXPRTY キュー・マネージャー・パラメーターまでの範囲でなければなりません。詳しくは、 DISPLAY QMGR を参照してください。 デフォルト値はゼロです。

このパラメーターは、MQSET API 呼び出しを使用して変更することもできます。

トリガー・タイプ
トリガー・メッセージを開始キューに書き込むかどうか、またどの条件で書き込むかを指定します。 開始キューは、(INITQパラメーターによって指定されます。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
最初 (First)
キューのTRIGMPRIパラメーターで指定された優先順位以上の優先順位の最初のメッセージがキューに到着するたび。 これがデフォルト値です。
EVERY
キューのTRIGMPRIパラメーターによって指定された優先順位以上の優先順位で、メッセージがキューに到着するたび。
奥行き
TRIGMPRIで指定された優先順位以上の優先順位を持つメッセージの数が、TRIGDPTHパラメーターで指定された数と等しい場合。
NONE
トリガー・メッセージは書き込まれません。

このパラメーターは、MQSET API 呼び出しを使用して変更することもできます。

使用法
キューの用途。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
正規 (Normal)
キューは送信キューではありません。
XMITQ
このキューは伝送キューで、リモート・キュー・マネージャー宛てのメッセージを保留するために使用されます。 アプリケーションがリモート・キューにメッセージを書き込むと、そのメッセージは適切な伝送キューに保管されます。 メッセージはそこで、リモート・キュー・マネージャーに伝送されるのを待ちます。

このオプションを指定する場合は、CLUSTERおよび CLUSNLの値を指定しないでください。

[z/OS]さらに、 z/OSでは、 INDXTYPE(MSGTOKEN) も INDXTYPE(GROUPID) も指定しないでください。

XMITQ (ストリング)
メッセージをそのリモート・キューに転送するのに使用する伝送キューの名前。 XMITQは、リモート・キューまたはキュー・マネージャーの別名定義で使用されます。

このパラメーターは、リモート・キューでのみサポートされます。

XMITQがブランクの場合、RQMNAMEと同じ名前のキューが伝送キューとして使用されます。

定義がキュー・マネージャーの別名として使用され、RQMNAMEがローカル・キュー・マネージャーの名前である場合、このパラメーターは無視されます。

また、この定義が応答先キュー別名定義 として使用されている場合にも、これは無視されます。