DEFINE キュー
MQSC DEFINE コマンドは、ローカル・キュー、モデル・キュー、またはリモート・キュー、あるいはキュー別名、応答先キュー別名、キュー・マネージャー別名を定義するために使用します。
MQSC コマンドの使用
MQSC コマンドの使用方法については、 MQSC コマンドを使用したローカル管理タスクの実行を参照してください。
このコマンドはソースから発行できます 2CR
。 ソースのシンボルの説明については、 z/OS®で MQSC コマンドを発行できるソースを参照してください。
DEFINE queues の使用上の注意
- コマンドが正常に完了しても、アクションが完了したことを意味するわけではありません。 真の完了を確認するには、 分散ネットワークの非同期コマンドが終了したことの確認の DEFINE キュー のステップを参照してください。
- ローカル・キューの場合
- キュー共有グループ内の別のキュー・マネージャーが既にローカル・バージョンのキューを持っている場合でも、
QSGDISP(SHARED)
を使用してローカル・キューを定義できます。 ただし、ローカル定義キューにアクセスしようとすると、理由コードMQRC_OBJECT_NOT_UNIQUE
(2343) で失敗します。 同じ名前を持つキューのローカル・バージョンは、タイプQLOCAL
、QREMOTE
、または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)
- キュー共有グループ内の別のキュー・マネージャーが既にローカル・バージョンのキューを持っている場合でも、
- 別名キューの場合 :
DEFINE QALIAS( aliasqueue ) TARGET( otherqname ) CLUSTER( c )
は、aliasqueue
という名前でキューotherqname
を公示します。DEFINE QALIAS( aliasqueue ) TARGET( otherqname )
では、otherqname
という名前で通知されたキューを、aliasqueue
という名前でこのキュー・マネージャーで使用することができます。- TARGTYPE および TARGET はクラスター属性ではありません。つまり、クラスター環境内では共有されていません。
- リモート・キューの場合 :
DEFINE QREMOTE( rqueue ) RNAME( otherq ) RQMNAME( otherqm ) CLUSTER( cl )
は、このキュー・マネージャーを、キューrqueue
のメッセージを送信できるストア・アンド・フォワード・ゲートウェイとして公示します。 ローカル・キュー・マネージャー以外では、このコマンドに応答先キューの別名としての効果はありません。DEFINE QREMOTE( otherqm ) RNAME() RQMNAME( anotherqm ) XMITQ( xq ) CLUSTER
は、このキュー・マネージャーを、anotherqm
のメッセージを送信できるストア・アンド・フォワード・ゲートウェイとして通知します。- RQMNAME は、それ自体をクラスター内のクラスター・キュー・マネージャーの名前にすることができます。 したがって、(QALIAS 定義と同様に) 公示されたキュー・マネージャー名を、ローカル側で別の名前にマッピングすることができます。 パターンは QALIAS 定義の場合と同様です。
- RQMNAME 自体がクラスター・キュー・マネージャーである場合は、 RQMNAME と QREMOTE の値を同じにすることができます。 この定義についても CLUSTER 属性を使用して公示した場合は、クラスター・ワークロード出口でローカル・キュー・マネージャーを選択しないでください。 そのように選択すると、循環定義になってしまいます。
- リモート・キューは、ローカル側で定義する必要はありません。 この利点としては、アプリケーションは単純なローカル定義名でそのキューを参照できるので便利だという点です。 この場合、キュー名はキューがあるキュー・マネージャーの名前で修飾されます。 ローカル定義を使用するときには、アプリケーションがそのキューの実際の位置を知らなくてもかまいません。
- リモート・キュー定義は、キュー・マネージャーの別名定義や、応答先キューの別名定義を保持するための手段としても利用できます。 その場合、定義の名前は次のいずれかになります。
- キュー・マネージャー名。別のキュー・マネージャー名の別名 (キュー・マネージャーの別名) として使用されます。
- キュー名。応答先キューの別名 (応答先キュー別名) として使用されます。
DEFINE QUEUE および ALTER QUEUE のパラメーターの説明
パラメーター | ローカル・キュー | モデル・キュー | 別名キュー | リモート・キュー |
---|---|---|---|---|
ACCTQ | ||||
BOQNAME | ||||
BOTHRESH (BOTHRESH) | ||||
CAPEXPRY | ||||
CFSTRUCT (CFSTRUCT) | ||||
CLCHNAME | ||||
CLUSNL | ||||
クラスター | ||||
CLWLPRTY | ||||
CLWLRANK | ||||
CLWLUSEQ | ||||
CMDSCOPE | ||||
カスタム | ||||
DEFBIND | ||||
DEFPRESP | ||||
DEFPRTY | ||||
DEFPSIST | ||||
DEFREADA (DEFREADA) | ||||
DEFSOPT | ||||
「DEFTYPE」 | ||||
「DESCR」 | ||||
DISTL | ||||
FORCE | ||||
取得 | ||||
HARDENBO または NOHARDENBO | ||||
IMGRCOVQ (IMGRCOVQ) | ||||
「INDXTYPE」 | ||||
INITQ | ||||
LIKE | ||||
MAXDEPTH | ||||
MAXFSIZE | ||||
MAXMSGL | ||||
MONQ | ||||
MSGDLVSQ | ||||
置き換えなし | ||||
NPMCLASS | ||||
PROCESS | ||||
PROPCTL | ||||
PUT | ||||
queue-name |
||||
QDEPTHHI | ||||
QDEPTHLO | ||||
QDPHIEV | ||||
QDPLOEV | ||||
QDPMAXEV | ||||
QSGDISP | ||||
QSVCIEV | ||||
QSVCINT | ||||
REPLACE | ||||
RETINTVL | ||||
RNAME | ||||
「RQMNAME」 | ||||
SCOPE | ||||
SHARE または NOSHARE | ||||
STATQ | ||||
「STGCLASS」 | ||||
ターゲット | ||||
ターゲット・キュー | ||||
ターゲット・タイプ | ||||
TRIGDATA | ||||
TRIGDPTH | ||||
TRIGGER または NOTRIGGER | ||||
TRIGMPRI | ||||
トリガー・タイプ | ||||
使用法 | ||||
XMITQ |
- キュー名
- キューのローカル名。ただし、リモート・キューのローカル定義に使用されているリモート・キューは除きます。
- ACCTQ
- キューのアカウンティング・データ収集を使用可能にするかどうかを指定します。 z/OSでは、収集されるデータはクラス 3 アカウンティング・データ (スレッド・レベルおよびキュー・レベルのアカウンティング) です。 このキューでアカウンティング・データを収集するには、この接続のアカウンティング・データも使用可能にする必要があります。 ACCTQ キュー・マネージャー属性、または MQCONNX 呼び出しの
MQCNO
構造体のオプション・フィールドのいずれかを設定して、アカウンティング・データ収集をオンにします。- QMGR
- アカウンティング・データの収集は、キュー・マネージャー定義のACCTQパラメーターの設定に基づきます。
- ON
- ACCTQキュー・マネージャー・パラメーターの値が NONE でない限り、キューのアカウンティング・データ収集は有効になります。
- オフ
- このキューではアカウンティング・データ収集は使用不可になります。
- BOQNAME (キュー名)
- 過度バックアウト・リキュー名。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
このパラメーターは、ローカル・キューまたはモデル・キューのバックアウト・キュー名属性を設定または変更するときに使用します。 キュー・マネージャーは、その値を照会できるようにする以外には、この属性の値に基づいて何も行いません。 IBM MQ classes for JMS は、最大回数バックアウトされたメッセージをこのキューに転送します。 最大値は、BOTHRESH属性によって指定されます。
- BOTHRESH (整数)
- バックアウトしきい値。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
このパラメーターは、ローカル・キューまたはモデル・キューのバックアウトしきい値属性の値を設定または変更するときに使用します。 キュー・マネージャーは、その値を照会できるようにする以外には、この属性の値に基づいて何も行いません。 IBM MQ classes for JMS は、この属性を使用して、メッセージのバックアウトを許可する回数を決定します。 この値を超えると、メッセージは BOQNAME 属性で指定されたキューに転送されます。
値は 0 から 999,999,999 の範囲で指定します。
- CFSTRUCT (構造名)
- 共有キューを使用する際にメッセージを保管するカップリング・ファシリティー構造の名前を指定します。
このパラメーターは、ローカル・キューおよびモデル・キューの z/OS でのみサポートされます。
名前には次の条件があります。- 12 文字より長くすることはできません。
- 先頭の文字は大文字 (A から Z) でなければなりません。
- 使用できる文字は A から Z と 0 から 9 だけです。
指定した名前には、キュー・マネージャーが接続されるキュー共有グループの名前が接頭部として付きます。 キュー共有グループの名前は必ず 4 文字で、必要に応じて記号 @ が埋め込まれます。 例えば、
NY03
という名前のキュー共有グループを使用し、PRODUCT7
という名前を指定した場合、結果のカップリング・ファシリティー構造体名はNY03PRODUCT7
になります。 キュー共有グループの管理構造体 (この場合はNY03CSQ_ADMIN
) をメッセージの保管に使用することはできません。ALTER QLOCAL、 ALTER QMODEL、 REPLACEを指定した 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 属性も設定する必要があります。これにより、複数のチャネルから同時に伝送キューにアクセスできます。CLCHNAMEで
"
を指定する場合、チャネル・プロファイル名を取得するには、チャネル・プロファイル名を引用符で囲んで指定する必要があります。 総称チャネル名を引用符で囲んで指定しなかった場合は、メッセージ CSQ9030E を受け取ります。*
"デフォルトのキュー・マネージャー構成では、すべてのクラスター送信側チャネルがメッセージを単一の伝送キュー
SYSTEM.CLUSTER.TRANSMIT.QUEUE
から送信します。 デフォルト構成は、キュー・マネージャー属性を変更することによって変更できて。DEFCLXQ 属性のデフォルト値は SCTQ です。 この値は CHANNEL に変更できます。 DEFCLXQ 属性を CHANNEL に設定すると、各クラスター送信側チャネルは、デフォルトで特定のクラスター伝送キューSYSTEM.CLUSTER.TRANSMIT.ChannelName
を使用するようになります。z/OSでは、このパラメーターが設定されている場合、キューは以下のようになります。- 共有可能でなければならない (キュー属性 SHARE を指定)。
- 相関 ID に索引付けされていなければならない (INDXTYPE(CORRELID) を指定)。
- 動的キューや共有キューであってはならない。
- CLUSNL (名前リスト名)
- そのキューが属しているクラスターのリストを指定する、NAMELISTの名
前です。
このパラメーターは、別名キュー、ローカル・キュー、およびリモート・キューでのみサポートされます。
このパラメーターの変更は、既に開いているキューの インスタンスには影響しません。
CLUSNL または CLUSTER の結果の値のうち、ブランク以外の値にできるのは片方だけです。両方に 1 つの値を指定することはできません。
ローカル・キューの場合、次のキューにはこのパラメーターは設定できません。- 伝送キュー
SYSTEM.CHANNEL.xx
キューSYSTEM.CLUSTER.xx
キューSYSTEM.COMMAND.xx
キュー- z/OS の場合のみ、
SYSTEM.QSG.xx
キュー
このパラメーターは、次のプラットフォームでのみ有効です。- UNIX, Linux®, and Windows
- z/OS
- CLUSTER (クラスター名)
- キューが属するクラスターの名前です。
このパラメーターは、別名キュー、ローカル・キュー、およびリモート・キューでのみサポートされます。
最大長は 48 文字で、 IBM MQ オブジェクトの命名規則に準拠しています。 このパラメーターの変更は、既に開いているキューの インスタンスには影響しません。
CLUSNL または CLUSTER の結果の値のうち、ブランク以外の値にできるのは片方だけです。両方に 1 つの値を指定することはできません。
ローカル・キューの場合、次のキューにはこのパラメーターは設定できません。- 伝送キュー
SYSTEM.CHANNEL.xx
キューSYSTEM.CLUSTER.xx
キューSYSTEM.COMMAND.xx
キュー- 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 操作の唯一の宛先です。
- の CMDSCOPE
- このパラメーターは、z/OS のみに適用されます。 キュー・マネージャーがキュー共有グループのメンバーである場合の、コマンドの実行場所を指定します。QSGDISPが GROUP または SHARED に設定されている場合、CMDSCOPEはブランクまたはローカル・キュー・マネージャーでなければなりません。
- ''
- コマンドは、コマンドが入力されたキュー・マネージャーで実行されます。
- QmgrName
- コマンドは、指定したキュー・マネージャーで実行されます。ただし、そのキュー・マネージャーは、キュー共有グループ内でアクティブである必要があります。
コマンドが入力されたキュー・マネージャー以外のキュー・マネージャー名を指定できます。 別の名前を指定できるのは、キュー共有グループ環境を使用しており、コマンド・サーバーが使用可能な場合に限られます。
- *
- コマンドはローカル・キュー・マネージャーで実行され、キュー共有グループ内のすべてのアクティブ・キュー・マネージャーにも渡されます。 * は、キュー共有グループ内のすべてのキュー・マネージャーでコマンドを入力するのと同じ結果をもたらします。
- CUSTOM (ストリング)
- 新機能用カスタム属性。
この属性には属性の値を含めます。属性の値として、属性名と値の各ペアを 1 つ以上のスペースで分離します。 属性名と値のペアの形式は、
NAME(VALUE)
です。最大長は IBM MQ 定数 MQ_CUSTOM_LENGTH によって定義され、現在はすべてのプラットフォームで 128 に設定されています。
CUSTOM 属性は、以下の IBM MQ 属性と一緒に使用することを意図しています。
- CAPEXPRY (整数)
- 解決パスのこのオブジェクトを使用したオブジェクト・ハンドルで書き込まれたメッセージが、有効期限切れによる処理対象になるまでの最大時間 (10 分の 1 秒単位)。
メッセージの有効期限処理について詳しくは、 有効期限を強制的に短くするを参照してください。
- 整数
- 1 から 999 999 999 までの範囲の値でなければなりません。
- NOLIMIT
- このオブジェクトを使用して書き込まれたメッセージの有効期限時間には制限がありません。 これがデフォルト値です。
- 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では、 N および Y は NO および YESの同義語として受け入れられます。
- の DEFREADA
- クライアントに配信される非持続メッセージのデフォルトの先読み動作を指定します。 先読みを有効にすると、非持続メッセージを消費するクライアント・アプリケーションのパフォーマンスを向上できます。
- NO
- クライアント・アプリケーションが先読みを要求するように構成されていない限り、非持続メッセージは先読みされません。
- はい
- 非持続メッセージは、アプリケーションからの要求がある前に、クライアントに送信されます。 クライアントが異常終了した場合、またはクライアントが送信されたすべてのメッセージを削除しない場合、 非持続メッセージは失われる可能性があります。
- disabled
- このキューに対して、非持続メッセージの先読みは有効になりません。 クライアント・アプリケーションによって先読みが要求されているかどうかに関わりなく、メッセージはクライアントに前もって送信されません。
- DEFSOPT
- アプリケーションがこのキューを入力用にオープンするときの、デフォルトの共有オプション。
- EXCL
- オープン要求は、キューからの排他入力用です。
- SHARED
- オープン要求は、キューからの共用入力用です。
- の DEFTYPE
- キュー定義タイプ。このパラメーターは、モデル・キューでのみサポートされます。
- PERMDYN
- 永続動的キューは、アプリケーションがオブジェクト記述子 (
MQOD
) で指定されたこのモデル・キューの名前を使用して MQOPEN MQI 呼び出しを発行すると作成されます。z/OSでは、動的キューの属性指定は QMGRです。
- 共用 DYN
- このオプションは z/OS でのみ使用可能です。
永続動的キューは、アプリケーションがオブジェクト記述子 (
MQOD
) に指定されたこのモデル・キューの名前を使用して MQOPEN API 呼び出しを発行すると作成されます。動的キューの属性指定は SHARED です。
- TEMPDYN
- 一時動的キューは、アプリケーションがオブジェクト記述子 (
MQOD
) に指定されたこのモデル・キューの名前を使用して MQOPEN API 呼び出しを発行すると作成されます。z/OSでは、動的キューの属性指定は QMGRです。
DEFPSISTパラメーターが YES のモデル・キュー定義には、この値を指定しないでください。
このオプションを指定する場合は、INDXTYPE(MSGTOKEN) を指定しないでください。
- DESCR (ストリング)
- 平文コメント。 オペレーターが DISPLAY QUEUE コマンドを実行したときに表示される、このオブジェクトについての記述情報です。
表示可能文字だけを含めることができます。 最大長は 64 文字です。 DBCS のインストール済み環境では、この値に DBCS 文字 (最大長 64 バイト) を使用できます。
注: このキュー・マネージャーのコード化文字セット ID (CCSID) に含まれる文字を使用してください。 それ以外の文字を使用し、情報が別のキュー・マネージャーに送信された場合には、正しく変換されないことがあります。 - DISTL (DISTL)
- パートナー・キュー・マネージャーが配布リストをサポートするかどうかを設定します。
- はい
- 配布リストは、パートナー・キュー・マネージャーによってサポート されます。
- NO
- 配布リストは、パートナー・キュー・マネージャーによってサポート されません。
注: このパラメーターは MCA によって設定されるため、通常は変更しません。 ただし、宛先キュー・マネージャーの配布先リスト機能が確認されている場合は、伝送キューの定義時にこのパラメーターを設定できます。このパラメーターは、 UNIX, Linux, and Windowsでのみ有効です。
- 強制 ( FORCE)
- このパラメーターは、別名キュー、ローカル・キュー、およびリモート・キュー上で ALTER コマンドのみに適用されます。
このパラメーターを指定すると、次のような状況でコマンドを強制的に終了します。
別名キューでは、次の記述が共に真である場合が該当します。- TARGET パラメーターは、キューを指定します。
- この別名キューをオープンしているアプリケーションがある。
ローカル・キューでは、次の記述が共に真である場合が該当します。- NOSHAREパラメーターが指定されている
- 複数のアプリケーションがそのキューを入力用にオープンしている。
FORCEは、以下の記述が両方とも真である場合にも必要です。- USAGEパラメーターが変更されました。
- そのキュー上に 1 つ以上のメッセージがあるか、1 つ以上のアプリケーションがそのキューをオープンしている。
キューにメッセージがある間は、USAGEパラメーターを変更しないでください。メッセージが伝送キューに書き込まれると、メッセージの形式が変更されます。
リモート・キューでは、次の記述が共に真である場合が該当します。- XMITQパラメーターが変更されました。
- このキューをリモート・キューとしてオープンしているアプリケーションが、1 つ以上ある。
FORCEは、以下の記述が両方とも真である場合にも必要です。- RNAME、RQMNAME、またはXMITQパラメーターのいずれかが変更される
- この定義を通じてキュー・マネージャーの別名を解決するアプリケーションの中に、キューをオープンしているものが 1 つ以上ある。
注: この定義が応答先キュー別名としてのみ使用されている場合は、 FORCE は必要ありません。説明されている状況でFORCEが指定されていない場合、コマンドは失敗します。
- 取得 ( GET)
- アプリケーションが、このキューからのメッセージの取得を許可されるかどうかを指定します。
- 有効
- 適切に許可されたアプリケーションが、キューからメッセージを取り出すことができます。
- disabled
- アプリケーションはキューからメッセージを検索できません。
このパラメーターは、MQSET API 呼び出しを使用して変更することもできます。
- HARDENBO & NOHARDENBO
- メッセージがバックアウトされた回数のカウントのハード化を行うかどうかを指定します。 カウントが固定されると、MQGET 操作によってメッセージが戻される前に、メッセージ記述子のBackoutCountフィールドの値がログに書き込まれます。 値をログに書き込むことにより、キュー・マネージャーの再始動の際に確実に正確な値にできます。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
バックアウト・カウントがハード化されている場合、このキューの持続メッセージの MQGET 操作のパフォーマンスは影響を受けます。
- HARDENBO
- このキューのメッセージのメッセージ・バックアウト・カウントは、カウントを正確にするためにハード化されます。
- バックアウト強化なし
- このキューのメッセージのメッセージ・バックアウト・カウントはハード化されず、キュー・マネージャーの再始動後も正確でない可能性があります。
注: このパラメーターは IBM MQ for z/OSにのみ影響します。 Multiplatforms では、このパラメーターは設定可能ですが、無効です。 - IMGRCOVQ (IMGRCOVQ)
- リニア・ロギングを使用する場合に、ローカル動的キュー・オブジェクトまたは永続動的キュー・オブジェクトをメディア・イメージからリカバリー可能にするかどうかを指定します。 指定可能な値は以下のとおりです。
- YES
- これらのキュー・オブジェクトはリカバリー可能です。
- NO
- rcdmqimg (レコード・メディア・イメージ) およびrcrmqobj (オブジェクトの再作成) コマンドは、これらのオブジェクトに対しては許可されず、これらのオブジェクトに対して自動メディア・イメージ (使用可能な場合) は書き込まれません。
- QMGR
- キュー・マネージャーを指定し、キュー・マネージャーのIMGRCOVQ属性に YES を指定した場合、これらのキュー・オブジェクトはリカバリー可能です。
QMGR を指定し、キュー・マネージャーの IMGRCOVQ 属性が NOを指定した場合、 rcdmqimg (メディア・イメージの記録) およびrcrmqobj (オブジェクトの再作成) コマンドはこれらのオブジェクトに対して許可されず、使用可能になっている場合、自動メディア・イメージはこれらのオブジェクトに対して書き込まれません。
QMGR がデフォルト値です。
このパラメーターは、z/OS では無効です。
- の INDXTYPE
- キューの MQGET 操作を円滑に行うためにキュー・マネージャーによって保持される索引のタイプ。 共用キューの場合は、索引のタイプにより、使用可能な MQGET 操作のタイプが決まります。
このパラメーターは、z/OS でのみサポートされます。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
以下の表に示すような適切な索引タイプが維持されている場合のみ、選択基準を使用してメッセージを取得することができます。
ここで、INDXTYPEパラメーターの値は、以下の値になります。表 2. 異なる検索選択基準のために必要な索引タイプ 検索選択基準 必要な索引タイプ 共用キュー その他のキュー なし (順次検索) 任意 任意 メッセージ ID MSGID または NONE 任意 相関 ID CORRELID 任意 メッセージ ID と相関 ID MSGID または CORRELID 任意 グループ ID GROUPID 任意 グループ化 GROUPID GROUPID メッセージ・トークン Not allowed MSGTOKEN - NONE
- 索引を維持しません。 通常、メッセージが順次検索される場合に、NONE を使用するか、または MQGET 呼び出しの選択基準としてメッセージ ID と相関 ID の両方を使用します。
- MSGID
- メッセージ ID の索引は保持されます。 MSGID は、通常、MQGET 呼び出しの選択基準としてメッセージ ID を使用し、相関 ID を NULL に設定してメッセージを検索する場合に使用します。
- CORRELID
- 相関 ID の索引は保持されます。 CORRELID は、通常、MQGET 呼び出しの選択基準として相関 ID を使用し、メッセージ ID を NULL に設定してメッセージを検索する場合に使用します。
- GROUPID
- グループ ID の索引は保持されます。 GROUPID は、メッセージ・グループ選択基準を使用してメッセージを検索する場合に使用します。注:
- キューが伝送キューの場合、INDXTYPEを GROUPID に設定することはできません。
- キューは
CFLEVEL(3)
の CF 構造体を使用して、INDXTYPE(グループ ID) で共有キューを指定する必要があります。
- MSGTOKEN
- メッセージ・トークンの索引は保持されます。 MSGTOKEN は、キューが、 z/OSのワークロード・マネージャー機能で使用する WLM 管理キューである場合に使用します。注: 以下の場合、 INDXTYPE を MSGTOKEN に設定することはできません。
- キューが定義タイプ 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では、キュー・マネージャーは、 QMGR、 COPY、または SHAREDの属性指定で指定された名前とキュー・タイプを持つオブジェクトを検索します。 LIKE オブジェクトの属性指定は、定義しているオブジェクトにはコピーされません。注:- QSGDISP(GROUP) オブジェクトは検索されません。
- QSGDISP(COPY) が指定されている場合、LIKEは無視されます。
- MAXDEPTH (整数)
- キューに書き込めるメッセージの最大数。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
次のプラットフォームでは、0 から 999999999 までの範囲の値を指定します。- UNIX, Linux, and Windows
- z/OS
他の要因によって、キューが引き続きフルと見なされることがあります。例えば、使用できるハード・ディスク・スペースがない場合などです。
この値を小さくした場合、既にキュー上にあるメッセージで、この新しい最大数を超えるメッセージがあってもそれはそのまま保持されます。
- の MAXFSIZE
- キュー・ファイルを拡張できる最大サイズ (メガバイト単位)。 この値を現在のキュー・ファイル・サイズより小さい値に構成している場合、キュー・ファイルのサイズがこのサイズを超える可能性があります。
- MAXMSGL (整数)
- このキューにおけるメッセージの最大長 (バイト)。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
UNIX, Linux, and Windowsでは、ゼロからキュー・マネージャーの最大メッセージ長までの範囲の値を指定します。
ALTER QMGR
コマンドの MAXMSGL パラメーター、 ALTER QMGR MAXMSGLを参照してください。z/OSでは、0 から 100 MB (104 857 600 バイト) の範囲の値を指定します。
メッセージ長には、ユーザー・データの長さと、ヘッダーの長さが含まれます。 伝送キューに入れられるメッセージには、伝送ヘッダーが追加されます。 メッセージ・ヘッダー全体として、追加の 4000 バイトを考慮してください。
この値を小さくしたために、既にキュー上にあるメッセージの長さが新しい最大数を超過しても、そのメッセージには影響がありません。
アプリケーションはこのパラメーターを使用して、キューからメッセージを取得するためのバッファーのサイズを決定できます。 したがって、この値を減らすことができるのは、アプリケーションが誤動作しないとわかっている場合のみです。
メッセージにデジタル署名と鍵を追加することにより、 Advanced Message Security ではメッセージの長さが増すことに注意してください。
- 月
- キューに関するオンライン・モニター・データの収集を制御します。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
- QMGR
- キュー・マネージャー・パラメーターMONQの設定に従って、モニター・データを収集します。
- オフ
- このキューのオンライン・モニター・データ収集はオフになります。
- 低い
- キュー・マネージャーのMONQパラメーターの値が NONE でない場合、このキューのオンライン・モニター・データ収集はオンになります。
- 中間
- キュー・マネージャーのMONQパラメーターの値が NONE でない場合、このキューのオンライン・モニター・データ収集はオンになります。
- 高い
- キュー・マネージャーのMONQパラメーターの値が NONE でない場合、このキューのオンライン・モニター・データ収集はオンになります。
このパラメーターを ALTER キュー・コマンドで使用した場合、変更はキューが次にオープンされたときに有効になります。
- MSGDLVSQ (MSGDLVSQ)
- メッセージ・デリバリー・シーケンス。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
- priority
- MQGET API 呼び出しによるメッセージの配布は、優先順位内の先入れ先出し (FIFO) 順序で行われます。
- FIFO
- MQGET API 呼び出しによるメッセージの配布は、FIFO 順で行われます。 このキューのメッセージについては、優先順位が無視されます。
メッセージ・デリバリー・シーケンス・パラメーターは、キューにメッセージがあるときに、PRIORITY から FIFO に変更できます。 既にキューにあるメッセージの順序は変更されません。 変更後にキューに追加されたメッセージには、そのキューのデフォルトの優先順位が適用されます。したがって、既存のメッセージより先に処理されるものもあります。
メッセージ・デリバリー・シーケンスを FIFO から PRIORITY に変更した場合は、キューの設定が FIFO であったときにキューに書き込まれたメッセージにはデフォルトの優先順位が適用されます。
注: INDXTYPE(GROUPID) に MSGDLVSQ(PRIORITY) が指定されている場合、グループが取得される優先順位は、各グループ内の最初のメッセージの優先順位に基づきます。 優先順位 0 と 1 は、キュー・マネージャーによって、論理順序でのメッセージの検索を最適化するために使用されます。 各グループ内の最初のメッセージには、これらの優先順位を使用しないでください。 使用すると、メッセージは優先順位 2 であるかのように保管されます。 - NPMCLASS (NPMCLASS)
- キューに書き込まれる非持続メッセージに割り当てる信頼性のレベル。
- 正規 (Normal)
- 非持続メッセージは、障害が発生したり、キュー・マネージャーがシャットダウンしたりすると失われます。 これらのメッセージは、キュー・マネージャーの再起動で廃棄されます。
- 高い
- キュー・マネージャーは、キュー・マネージャーの再始動または切り替えの間、このキューで非持続メッセージを保持しようとします。
このパラメーターは、 z/OSでは設定できません。
- PROCESS (ストリング)
- IBM MQ プロセスのローカル名です。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
このパラメーターは、トリガー・イベントが起こったときキュー・マネージャー によって開始されるアプリケーションを示す、プロセス・インスタンスの 名前です。IBM MQ オブジェクトの命名規則を参照してください。
プロセス定義は、ローカル・キューが定義されている場合は確認されませんが、トリガー・イベントを発生させるには使用可能でなければなりません。
キューが伝送キューである場合、プロセス定義には開始されるチャネルの名前が含まれています。 このパラメーターは、次のプラットフォームの伝送キューのためのオプションです。- IBM i
- UNIX, Linux, and Windows
- z/OS
- PROPCTL
- プロパティー制御属性。 この属性はオプションです。 ローカル・キュー、別名キュー、およびモデル・キューに適用されます。注: アプリケーションが別名キューをオープンする場合は、別名キューとターゲット・キューの両方にこの値を設定する必要があります。
- PUT (PUT)
- メッセージをキューに書き込むことができるかどうかを指定します。
- 有効
- キューにメッセージを追加できます (追加できるのは所定の許可を持つアプリケーション)。
- disabled
- メッセージをキューに追加することはできません。
このパラメーターは、MQSET API 呼び出しを使用して変更することもできます。
- QDEPTHHI (整数)
- キュー・サイズ上限イベントを生成する際にキューの長さの比較の対象になるしきい値。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
z/OS 上の共用キューがこのイベントに与える影響について詳しくは、 z/OS上の共用キューおよびキュー・サイズ・イベントを参照してください。
このイベントは、アプリケーションがキューにメッセージを書き込んだ結果、キュー上のメッセージ数がキュー・サイズ上限しきい値以上になったことを示しています。 QDPHIEVパラメーターを参照してください。
値は、最大キュー項目数 (MAXDEPTH パラメーター) に対するパーセンテージで表され、0 から 100 までの範囲で、QDEPTHLO以上でなければなりません。
- QDEPTHLO (整数)
- キュー・サイズ下限イベントを生成する際にキューの長さの比較の対象になるしきい値。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
z/OS 上の共用キューがこのイベントに与える影響について詳しくは、 z/OS上の共用キューおよびキュー・サイズ・イベントを参照してください。
このイベントは、アプリケーションがメッセージをキューから取り出した結果、キュー上のメッセージ数がキュー・サイズ下限しきい値以下になったことを示しています。 QDPLOEVパラメーターを参照してください。
この値は、最大キュー項目数 (MAXDEPTH パラメーター) に対するパーセンテージで表されます。この値は、0 から 100 までの範囲で、QDEPTHHI以下でなければなりません。
- QDPHIEV (QDPHIEV)
- キュー・サイズ上限イベントを生成するかどうかを制御します。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
キュー・サイズ上限イベントは、アプリケーションがキューにメッセージを書き込んだ結果、キュー上のメッセージ数がキュー・サイズ上限しきい値以上になったことを示しています。 QDEPTHHIパラメーターを参照してください。- 有効
- 「キュー項目数高」イベントが生成されます。
- disabled
- 「キュー項目数高」イベントは生成されません。
注: このパラメーターの値は、暗黙的に変更されることがあります。z/OSでは、共用キューがイベントに影響します。
このイベントについて詳しくは、 キュー・サイズ上限を参照してください。
- QDPLOEV (QDPLOEV)
- キュー・サイズ下限イベントを生成するかどうかを制御します。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
キュー・サイズ下限イベントは、アプリケーションがメッセージをキューから取り出した結果、キュー上のメッセージ数がキュー・サイズ下限しきい値以下になったことを示しています。 QDEPTHLOパラメーターを参照してください。- 有効
- 「キュー項目数低」イベントが生成されます。
- disabled
- 「キュー項目数低」イベントは生成されません。
注: このパラメーターの値は、暗黙的に変更されることがあります。z/OSでは、共用キューがイベントに影響します。
このイベントについて詳しくは、 キュー・サイズ下限を参照してください。
- QDPMAXEV
- キュー満杯イベントを生成するかどうかを制御します。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
キュー・フル・イベントは、キューがいっぱいであるために、キューへの書き込みが拒否されたことを示しています。 キュー・サイズは最大値に達しています。- 有効
- 「キュー・フル」イベントが生成されます。
- disabled
- 「キュー・フル」イベントは生成されません。
注: このパラメーターの値は、暗黙的に変更されることがあります。z/OSでは、共用キューがイベントに影響します。
このイベントについて詳しくは、 キュー・フルを参照してください。
- 「QSGDISP」
- このパラメーターは、z/OS のみに適用されます。
グループ内のオブジェクトの処理を指定します。
表 5. QSGDISP オプションのオブジェクト属性指定 QSGDISP DEFINE COPY オブジェクトは、 LIKE
オブジェクトと同じ名前のQSGDISP(GROUP)
オブジェクトを使用してコマンドを実行するキュー・マネージャーのページ・セットで定義されています。ローカル・キューの場合、メッセージは各キュー・マネージャーのページ・セットに保管され、そのキュー・マネージャーを介してのみ使用できます。
GROUP オブジェクト定義が共有リポジトリーに常駐しています。これは、共有キュー・マネージャー環境が存在する場合にのみ有効です。 定義が正常に実行されると、以下のコマンドが生成されます。 コマンドは、すべてのアクティブなキュー・マネージャーに送信されて、ページ・セット 0 上でローカル・コピーの作成またはリフレッシュが試行されます。
グループ・オブジェクトに対する DEFINE コマンドは、DEFINE QUEUE(q-name) REPLACE QSGDISP(COPY)
QSGDISP(COPY)
で生成されたコマンドが失敗したかどうかに関係なく有効になります。PRIVATE 許可されません。 QMGR オブジェクトは、コマンドを実行するキュー・マネージャーのページ・セットで定義されます。 ローカル・キューの場合、メッセージは各キュー・マネージャーのページ・セットに保管され、そのキュー・マネージャーを介してのみ使用できます。 SHARED このオプションは、ローカル・キューにのみ適用されます。 オブジェクトは共有リポジトリーで定義されます。 メッセージはカップリング・ファシリティーに保管されるので、キュー共有グループ内のすべてのキュー・マネージャーで使用できます。 SHARED を使用できるのは次の場合だけです。 CFSTRUCT
がブランクではないINDXTYPE
がMSGTOKEN
ではない- 以下のキューではない:
SYSTEM.CHANNEL.INITQ
SYSTEM.COMMAND.INPUT
- QSVCIEV (QSVCIEV)
- サービス間隔上限イベントまたはサービス間隔 OK イベントを生成するかどうかを制御します。
このパラメーターは、ローカル・キューおよびモデル・キューでのみサポートされ、共有キューで指定された場合は無効です。
サービス間隔上限イベントは、QSVCINTパラメーターで指定された時間以上、キューからメッセージが取得されなかったことが検査で示された場合に生成されます。
サービス間隔 OK イベントは、QSVCINTパラメーターで指定された時間内にキューからメッセージが取得されたことが検査で示された場合に生成されます。
注: このパラメーターの値は、暗黙的に変更されることがあります。 詳しくは、「 キュー・サービス間隔上限 」および「 キュー・サービス間隔 OK」のサービス間隔上限イベントおよびサービス間隔 OK イベントの説明を参照してください。- 高い
- サービス間隔高イベントが生成されます。
- OK
- サービス間隔 OK イベントが生成されます。
- NONE
- サービス間隔イベントは生成されません。
- QSVCINT (整数)
- サービス間隔上限およびサービス間隔 OK イベントを生成する際に、比較に使用されるサービス間隔。
このパラメーターは、ローカル・キューおよびモデル・キューでのみサポートされ、共有キューで指定された場合は無効です。
QSVCIEVパラメーターを参照してください。
値はミリ秒単位で、0 から 999999999 の範囲内でなければなりません。
- 置換 & NOREPLACE
- このオプションは、既存の定義をこの定義に置き換えるかどうかを制御します。注: IBM MQ for z/OSでは、既存の定義は、後処理が同じ場合にのみ置き換えられます。 属性指定が異なるオブジェクトは変更されません。
- REPLACE
- オブジェクトが存在している場合の結果は、ALTER コマンドに FORCE パラメーターを除くすべてのパラメーターを指定して実行した場合と似ています。 特に、既存のキューにあるメッセージはすべて保存されるのでご注意ください。
FORCE パラメーターを指定しない ALTER コマンドと、 REPLACE パラメーターを指定した DEFINE コマンドの間には違いがあります。 違いは、 ALTER は指定されていないパラメーターを変更しませんが、 REPLACE を指定した DEFINE はすべてのパラメーターを設定します。 REPLACE を使用すると、 指定されていないパラメーターは LIKE パラメーターに指定されたオブジェクトまたはデフォルト定義から取得され、置換対象のオブジェクトのパラメーターがあってもそれは無視されます。
次の記述が共に真である場合、コマンドは失敗します。- このコマンドは、 ALTER コマンドを使用する場合に FORCE パラメーターを使用する必要があるパラメーターを設定します。
- そのオブジェクトがオープンされている
このような状況では、ALTER コマンドに FORCE パラメーターを指定するとうまくいきます。
UNIX、 Linux、または Windowsで SCOPE(CELL) が指定され、セル・ディレクトリーに同じ名前のキューが既に存在する場合、 REPLACE が指定されていてもコマンドは失敗します。
- NOREPLACE
- 定義はオブジェクトのどの既存の定義も置き換えません。
- RETINTVL (整数)
- キューが定義されたときからの時間数。その時間が経過すれば、そのキューは不要となります。 値は 0 から 999,999,999 の範囲でなければなりません。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
CRDATE および CRTIME は、 DISPLAY QUEUE コマンドを使用して表示できます。
オペレーターとハウスキーピング・アプリケーションは、この情報に基づいて、不要になったキューを削除できます。
注: キュー・マネージャーは、この値に基づいてキューを削除することも、保存間隔が満了していないキューの削除を防止することもしません。 必要なアクションは、ユーザーの責任で行ってください。 - RNAME (ストリング)
- リモート・キューの名前。 このパラメーターは、RQMNAMEで指定されたキュー・マネージャーで定義されたキューのローカル名です。このパラメーターは、リモート・キューでのみサポートされます。
- この定義がリモート・キューのローカル定義に使用される場合、オープン時にRNAMEがブランクであってはなりません。
- この定義がキュー・マネージャー別名定義に使用される場合、オープン時にRNAMEはブランクでなければなりません。
キュー・マネージャー・クラスターでは、この定義はこのクラスターを作成したキュー・マネージャーのみに適用されます。 クラスター全体に別名を通知するには、リモート・キュー定義にCLUSTER属性を追加します。
- この定義が応答先キュー別名に使用される場合、この名前は、応答先キューとなるキューの名前です。
- RQMNAME (ストリング)
- キューRNAMEが定義されているリモート・キュー・マネージャーの名前。このパラメーターは、リモート・キューでのみサポートされます。
- アプリケーションがリモート・キューのローカル定義をオープンする場合、RQMNAMEはブランクまたはローカル・キュー・マネージャーの名前であってはなりません。 オープン時に、XMITQがブランクの場合は、伝送キューとして使用されるこの名前のローカル・キューがなければなりません。
- この定義がキュー・マネージャー別名に使用される場合、RQMNAMEは別名が割り当てられるキュー・マネージャーの名前です。 これは、ローカル・キュー・マネージャーの名前であっても構いません。 あるいは、XMITQがブランクの場合、オープンが行われるときに、伝送キューとして使用されるこの名前のローカル・キューが存在している必要があります。
- 応答先 (reply-to) キュー別名にRQMNAMEを使用する場合、 RQMNAME は、応答先 (reply-to) キュー・マネージャーにするキュー・マネージャーの名前です。
- 有効範囲
- キュー定義の有効範囲を指定します。このパラメーターは、別名キュー、ローカル・キュー、およびリモート・キューでのみサポートされます。
- QMGR
- キュー定義の有効範囲は、キュー・マネージャー内です。 キューを所有するキュー・マネージャー以外では、キュー定義は適用しません。 別のキュー・マネージャーが所有する出力のキューを、次の 2 つの方法のいずれかで開くことができます。
- 所有キュー・マネージャーの名前を指定します。
- 他方のキュー・マネージャーにあるキューのローカル定義を開きます。
- CELL
- キュー定義の有効範囲は、セルになります。 セルの有効範囲とは、キューがそのセル内のすべてのキュー・マネージャーに認識されていることを意味します。 セルの有効範囲が指定されたキューは、キューの名前を指定するだけで、出力用に開くことができます。 キューを所有するキュー・マネージャーの名前を指定する必要はありません。
同じ名前を持つキューが既にセル・ディレクトリーにある場合、コマンドは失敗します。 REPLACEオプションは、この状態には影響しません。
値は、セル・ディレクトリーをサポートする名前サービスが構成されている場合にのみ有効です。制約事項: DCE ネーム・サービスはサポートされなくなりました。
このパラメーターは、 UNIX, Linux, and Windowsでのみ有効です。
- SHARE および NOSHARE
- 複数のアプリケーションがこのキューからメッセージを検索できるかどうかを指定します。このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
- SHARE
- 複数のアプリケーション・インスタンスがこのキューからメッセージを読み取ることができます。
- 非共有
- 1 つのアプリケーション・インスタンスのみがこのキューからメッセージを読み取ることができます。
- 状況
- 統計データ収集を有効にするかどうかを指定します。
- QMGR
- 統計データ収集は、キュー・マネージャーのSTATQパラメーターの設定に基づきます。
- ON
- キュー・マネージャーのSTATQパラメーターの値が NONE でない場合、キューの統計データ収集は有効になります。
- オフ
- キューの統計データ収集は使用不可になります。
このパラメーターを ALTER キュー・コマンドで使用した場合、変更は、パラメーターの変更後に作成された、キュー・マネージャーへの接続に対してのみ有効になります。
このパラメーターは、 Multiplatformsでのみ有効です。
- STGCLASS (ストリング)
- ストレージ・クラスの名前。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
注: このパラメーターを変更できるのは、キューが空でクローズされている場合のみです。このパラメーターはインストール時に定義した名前です。 名前の 1 番目の文字は英大文字 A から Z、2 番目の文字以降は英大文字の A から Z か数字の 0 から 9 でなければなりません。
このパラメーターは z/OS でのみ有効です。ストレージ・クラスを参照してください。
- TARGET (ストリング)
- 別名として使用するキューまたはトピック・オブジェクトの名前。IBM MQ オブジェクトの命名規則を参照してください。 オブジェクトは、TARGTYPEによって定義されたキューまたはトピックにすることができます。 最大長は 48 文字です。
このパラメーターは、別名キューでのみサポートされます。
このオブジェクトは、アプリケーション・プロセスが別名キューをオープンするときにのみ定義する必要があります。
- TARGTYPE (ストリング)
- 別名の解決先のオブジェクトのタイプ。
- QUEUE
- 別名はキューに解決されます。
- トピック
- 別名はトピックに解決されます。
- TRIGDATA (ストリング)
- トリガー・メッセージに挿入されるデータ。 ストリングの最大長は 64 バイトです。
このパラメーターは、ローカル・キューとモデル・キューでのみサポートされます。
伝送キューの場合には、このパラメーターを使用して、開始するチャネルの名前を指定することができます。
このパラメーターは、MQSET API 呼び出しを使用して変更することもできます。
- TRIGDPTH (整数)
- TRIGTYPEがDEPTHの場合、トリガー・メッセージが書き込まれる前にキューに入っていなければならないメッセージの数。 値は 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では、 INDXTYPE(MSGTOKEN) も INDXTYPE(GROUPID) も指定しないでください。
- XMITQ (ストリング)
- メッセージをそのリモート・キューに転送するのに使用する伝送キューの名前。 XMITQは、リモート・キューまたはキュー・マネージャーの別名定義で使用されます。
このパラメーターは、リモート・キューでのみサポートされます。
XMITQがブランクの場合、RQMNAMEと同じ名前のキューが伝送キューとして使用されます。
定義がキュー・マネージャーの別名として使用され、RQMNAMEがローカル・キュー・マネージャーの名前である場合、このパラメーターは無視されます。
また、この定義が応答先キュー別名定義 として使用されている場合にも、これは無視されます。