チャネル・プロパティー

クライアント接続チャネルなど、すべてのタイプのチャネルにプロパティーを設定することができます。 一部のプロパティーは、特定のタイプのチャネルに固有です。

下の表には、設定できるすべてのプロパティーがリストされています。

プロパティーによっては、すべてのタイプのチャネルには適用されないものもあります。
  • 一部のプロパティーは、クラスター・チャネルに固有のものです。
  • [z/OS]一部のプロパティーは、 z/OS® チャネルに固有のものです。

それぞれのプロパティーについて、その構成時に必要となる簡単な説明を記載しています。 また、表には、DEFINE、ALTER、および DISPLAY CHANNEL コマンド用の同等の MQSC パラメーターも記載してあります。 MQSC コマンドについて詳しくは、「 IBM Documentation」の「 MQSC コマンドを使用した IBM® MQ の管理 」を参照してください。

「一般」ページ

下の表には、 「チャネル・プロパティー」 ダイアログの 「一般」 ページで設定するプロパティーがリストされています。

Property 意味 MQSC パラメーター
チャネル名 読み取り専用。 チャネル定義の名前。 CHANNEL
タイプ 読み取り専用。 チャネル定義のタイプ。 CHLTYPE
QSG 処理 読み取り専用。 チャネル定義のキュー共用グループ処理。 作成後にはチャネル定義の処理を変更できません。 Queue manager は、オブジェクト定義をホストするキュー・マネージャーのみがそのオブジェクト定義を使用できることを意味します。Group は、オブジェクト定義が共有リポジトリーに保管されていてキュー共有グループ内のキュー・マネージャーごとに定義のコピーが存在することを意味します。Copy は、オブジェクト定義が共有リポジトリーにおいてキュー・マネージャーの定義コピーであることを意味します。 QSGDISP
説明 チャネルの目的についての分かりやすい説明を入力します。 プロパティー・ダイアログのストリングを参照してください。 DESCR
キュー・マネージャー名 チャネルが定義されるキュー・マネージャーの名前を入力します。 クライアント接続チャネルの場合は、MQI クライアント環境で実行中のアプリケーションが接続を要求できる、 接続先キュー・マネージャーの名前を入力します。 QMNAME
伝送プロトコル チャネルが使用するトランスポート・タイプをリストから選択します。 TRPTYPE
接続名 クラスター受信側チャネルを除くすべてのチャネルについて、宛先キュー・マネージャーをホストする コンピューターの名前を入力します。 接続名の形式は、選択された伝送プロトコルに応じて異なります。 例えば、TCP/IP プロトコルを使用していて、ターゲット・キュー・マネージャーが IBM MQ デフォルトである 1414 以外のポート番号を使用して接続していることが分かっている場合は、computer_name(port_number) と入力します。ここで、computer_name はターゲット・キュー・マネージャーをホストするコンピューターの名前または IP アドレスで、port_number はターゲット・キュー・マネージャーのリスナーが使用しているポートです。

[AIX、Linux、Windows] AIX®, Linux®, and Windows上のクラスター受信側チャネルで TCP/IP トランスポート・プロトコルを使用する場合は、このプロパティーに値を指定しないでください。 IBM MQ は、システムのデフォルト・ポートと現行 IPv4 アドレスを想定して、使用する名前を生成します。 システムに IPv4 アドレスがない場合、システムの現在の IPv6 アドレスが使用されます。 それ以外のプラットフォーム上のクラスター受信側チャネルや、TCP/IP トランスポート・プロトコルを使用しないクラスター受信側チャネルの場合は、ローカル・キュー・マネージャーをホストするコンピューターの名前を入力します。

CONNAME
伝送キュー チャネルの受信側終端にあるキュー・マネージャーに対応する伝送キューの名前を入力します。 XMITQ
ローカル通信アドレス チャネルが TCP/IP を使用しており、アウトバウンド通信に特定の IP アドレス、ポート、 またはポート範囲をチャネルが使用するようにしたい場合、チャネルのローカル通信アドレスを入力します。 チャネルはアドレスにローカルにバインドされます。 使用する形式ipaddress(low-port, high-port)ここで、 ipaddress は、 IPv4 小数点付き 10 進数、 IPv6 16 進数、または英数字のホスト名形式で指定された IP アドレスです。 例:192.0.2.0任意のポートを持つ IPv4 アドレスを指定します。192.0.2.0(1000)IPv4 アドレスと特定のポートを指定します。192.0.2.0(1000,2000)IPv4 アドレスおよびポートの範囲を指定します。(1000)ポートのみを指定します。

Cluster-sender channels: 手動で定義したクラスター送信側チャネルの Local communication address フィールドに値を入力すると、フル・リポジトリー・キュー・マネージャーとの通信が確立されるときに、この値はフル・リポジトリーのクラスター受信側チャネルの値で上書きされます。 手動で定義されたクラスター送信側チャネルに値を指定するだけでなく、自動的に定義されたクラスター送信側チャネルに Local communication address プロパティーの値を強制するチャネル自動定義出口を作成する必要があります。

LOCLADDR
 

Cluster-receiver channels: すべてのキュー・マネージャーが同じコンピューター上にある場合を除き、クラスター受信側チャネルの Local communication address フィールドに IP アドレスを入れないでください。 これは、クラスター受信側チャネルの Local communication address フィールドに IP アドレスを指定してキュー・マネージャーに接続しようとするキュー・マネージャーの値が、自動定義されたクラスター送信側チャネルに伝搬されるためです。 ただし、クラスター内のすべてのキュー・マネージャーがすべてのアウトバウンド通信に特定のポートまたはポート範囲を使用するようにしたい場合は、クラスター受信側チャネルの Local communication address フィールドにポート番号またはポート範囲を入れることができます。

 
全チャネル状況 読み取り専用。 チャネルの状態。 状況

「拡張」ページ

下の表には、 「チャネル・プロパティー」 ダイアログの 「拡張」 ページで設定するプロパティーがリストされています。

Property 意味 MQSC パラメーター
最大メッセージ長 チャネル上で伝送することができるメッセージの最大長を入力します。
  • 以下のプラットフォーム上では、この値はゼロ以上、キュー・マネージャーの最大メッセージ長以下でなければなりません。
    • [AIX]AIX
    • [IBM i]IBM i
    • [Windows]Windows
    • VSE/ESA
  • 他の Multiplatforms では、この値はゼロ以上、4,194,304 バイト以下でなければなりません。
  • [z/OS] IBM MQ for z/OSでは、この値は、ゼロ以上 104,857,600 バイト以下でなければなりません。
MAXMSGL
ハートビート間隔 0 から 999999 の範囲でハートビート間隔の長さを入力します。 ゼロの値は、ハートビート交換が行われないことを意味します。 この値は、Disconnect interval プロパティーの値より小さくなるように設定してください。 使用される値は、送信側で指定された値と受信側で指定された値のうちどちらか大きい方です。 ハートビート間隔は、伝送キューにメッセージがない時に送信側 MCA から渡されるハートビート・フロー間の時間 (秒数) です。 ハートビート交換は、受信 MCA にチャネルを静止する機会を提供します。 HBINT
最大インスタンス数

このパラメーターは、サーバー接続チャネルおよび AMQP チャネルで使用します。 Maximum instances は、個別のサーバー接続チャネルまたは AMQP チャネルの同時インスタンスの最大数を指定します。

この値の範囲は、0 から 999999999 までです。 デフォルト値は 999999999 です。

ゼロの値を指定すると、すべてのクライアント・アクセスが禁止されます。

Maximum instances が、現在実行中のサーバー接続チャネルのインスタンス数より小さい値に設定されている場合は、十分な数の既存のインスタンスが実行を停止するまで、新規インスタンスは禁止されます。

既に接続されている ID を使用してクライアントが AMQP チャネルで接続すると (つまり、クライアントの引き継ぎが実行される場合)、クライアント接続数が MAXINST に達しているかどうかに関係なく、この引き継ぎは正常に行われます。

MAXINST
クライアントあたりの最大インスタンス数

このパラメーターは、サーバー接続チャネルで使用します。 Maximum instances per client は、単一のクライアントから開始可能な、個別のサーバー接続チャネルの同時インスタンスの最大数を指定します。 このコンテキストでは、同じリモート・ネットワーク・アドレスから発信された接続は、同じクライアントから着信したものと見なされます。

この値は、0 から 999999999 までの数値です。 デフォルト値は 999999999 です。

ゼロの値を指定すると、すべてのクライアント・アクセスが禁止されます。

Maximum instances が接続の最大数であるという点で、Maximum instancesMaximum instances per client と異なりますが、Maximum instances per client は、各クライアントがサーバーに接続できる接続の最大数です。

MAXINSTC
キープアライブ間隔 0 から 99999 の範囲でキープアライブ間隔の長さを入力します。 チャネルが TCP または SPX 以外のトランスポート・タイプを使用する場合、このプロパティーは無視されます。 TCP Keep alive プロパティーを Yesキュー・マネージャー・プロパティーのチャネル・ページで設定する必要があります。

[z/OS] z/OS キュー・マネージャーの場合、 Keep alive interval プロパティーは、個々のチャネルのキープアライブ間隔を指定します。

[UNIX、Linux、Windows、IBM i]Multiplatforms 上のキューマネージャでは、Keep alive interval プロパティは、チャネルが z/OS キューマネージャに接続する場合にのみ使用されます。Keep alive interval プロパティによって提供される機能を使用するには、Keep alive interval プロパティを Auto に設定して、ネゴシエートされたハートビート間隔の値に基づいた値を使用してください。

KAINT
シーケンス番号折り返し シーケンス番号は、チャネルを介して送信されたメッセージのカウントです。 シーケンス番号は、チャネルを介してメッセージが送信されるたびに大きくなります。

[z/OS] CICS®を使用する z/OS の場合は、1 から 999999999 までの範囲で、メッセージ・シーケンス番号が 1 で再始動する前に到達する最大番号を入力します。

他のすべてのプラットフォームの場合は、100 から 999999999 の範囲でメッセージ・シーケンス番号の最大数を指定します。この最大数に達すると、メッセージ・シーケンス番号 1 から再始動します。

値は、以前のメッセージで使用されているうちにその番号が再発行されることがないように、十分に高い値にする必要があります。 チャネルの両端は、チャネルの始動時に同じシーケンス番号折り返し値を持っていなければなりません。そうでない場合は、エラーを受け取ります。

SEQWRAP
非持続メッセージ速度

チャネル上の非持続メッセージがトランザクション内で転送されないことを指定するには、「高速」を選択します。 これは、非持続メッセージが、トランザクションの一部である場合よりもはるかに高速に、検索に利用できるようになることを意味します。 ただし、非持続メッセージはトランザクションの一部でないため、例えばメッセージの転送中にチャネルが停止した場合に、メッセージが失われる可能性があります。 これが生じることを避けるには、「通常」を選択します。 NPMSPEED
バッチ・サイズ 同期点に達する前に送信されるメッセージの最大数を入力します。 メッセージは、常に個別に転送されますが、バッチとしてコミットまたはバックアウトされます。 次のデフォルトのバッチ・サイズを試してください:50必要な場合にのみ値を変更してください。 BATCHSZ
メッセージ圧縮 「編集」をクリックして、「メッセージ圧縮の編集」ダイアログを開きます。 チャネル定義でサポートされているメッセージの圧縮法を優先順に選択します。 チャネルのもう一方の終端でサポートされている最初の技法が使用されます。 「なし」 は、メッセージ圧縮が実行されないことを意味します。 RLE は、メッセージ・データ圧縮が実行長エンコードを使用して実行されることを意味します。 ZLIBFAST は、zlib 圧縮技法を使用してメッセージ・データ圧縮が実行され、高速圧縮時間が推奨されることを意味します。 ZLIBHIGH は、zlib 圧縮技法を使用してメッセージ・データ圧縮が実行され、高水準の圧縮が推奨されることを意味します。 [MQ 9.4.0 2024 年 6 月][UNIX、Linux、Windows、IBM i]LZ4FASTは、LZ4圧縮技術を使用してメッセージデータ圧縮が実行され、速い圧縮時間が好ましいことを意味する。 LZ4HIGHは、LZ4の圧縮技法を用いてメッセージデータの圧縮が行われることを意味し、高い圧縮レベルが好まれる。

ANY は、キュー・マネージャーでサポートされる任意の圧縮技法を使用できることを意味します。

詳細はIBM Documentation分散待ち行列とクラスタを参照。

COMPMSG
ヘッダー圧縮 「編集」をクリックして、「ヘッダー圧縮の編集」ダイアログを開きます。 チャネル定義でサポートされているヘッダーの圧縮法を優先順に選択します。 チャネルのもう一方の終端でサポートされている最初の技法が使用されます。 「なし」はヘッダーの圧縮を行わないことを、「システム」はヘッダーの圧縮を行うことをそれぞれ示しています。 詳細はIBM Documentation分散待ち行列とクラスタを参照。 COMPHDR
バッチ間隔 0 から 999999999 の範囲で、伝送キューにメッセージがない場合でもチャネルがバッチを開いておく時間をミリ秒単位で入力します。 BATCHINT
バッチ・データ制限 同期点を取得するまでに、1 つのチャネルを通じて送信されるデータ量の制限を、0 から 999999 の範囲のキロバイト数で指定します。 0 の値は、このチャネルを通じて送信されるバッチにデータ制限が適用されないことを意味します。 BATCHLIM
切断間隔 0 から 999999 の範囲で、バッチの終了後にチャネルがクローズするまでの秒数を入力します。 0 の値は、チャネルが切断しないことを意味します。 DISCINT
データ変換 メッセージが受信アプリケーションによって、受信システムで必要な形式に変換されるように指定する には (通常の方式)、「いいえ」を選択します。 データ変換をサポートしないプラットフォーム上にリモート・キュー・マネージャーがある場合は、「はい」を選択して、 伝送前に、受信システムで必要な形式に変換されるように指定します。 CONVERT
書き込む権限 このプロパティーは、MQPUT コマンドを宛先キューに対して実行するとき、または MQI 呼び出しを実行するときに、 メッセージ・チャネル・エージェント (MCA) によって実行されるセキュリティー処理のタイプを指定します。 デフォルトのユーザー ID を使用するには、「デフォルト」をクリックします。 メッセージに関連付けられているコンテキスト情報からの代替ユーザー ID を使用する場合 は、「コンテキスト」をクリックします。 PUTAUT
バッチ・ハートビート間隔

送信側チャネルが「バッチ・ハートビート間隔」の限度内で受信側チャネルからの通信を受信している場合、受信側チャネルは引き続きアクティブであると見なされます。この間隔を超えた場合、「ハートビート」が受信側チャネルに送信されて検査されます。 送信側チャネルは、チャネルのハートビート間隔 (HBINT) プロパティーで指定された秒数に基づいて、その間隔の間、チャネルの受信側からの応答を待機します。

チャネルの受信側がアクティブでなかった場合、バッチを未確定にせずにバックアウトすることができます。 バッチをバックアウトすることにより、メッセージが使用可能な状態で維持され、別のチャネルにリダイレクトするなどの処理が可能となります。 チャネルの受信側を非アクティブと見なす前に、 チャネルの送信側がチャネルの受信側からの応答を待機する秒数を 0 から 999999 の範囲で入力します。

0 の値は、バッチ・ハートビートが使われないことを意味します。 詳しくは、「疑われる」機会を減らすためにチャンネルを設定するをご覧ください。

BATCHHB
デフォルト・チャネル配置 チャネル処理キーワード (CHLDISP) を指定しないで START CHANNEL コマンドを実行すると、「デフォルト・チャネル処理」(DEFCDISP) の値に基づいてチャネルが開始されます。 有効な値は以下の 3 つです。

Private。 これがデフォルト値です。 ローカル・キュー・マネージャーで、専用チャネルとして開始されます。

「共有」。 受信側チャネルがキュー共有グループ向けのインバウンド伝送に応答して開始された場合、これは共有です。 送信側チャネルの伝送キューの属性指定が SHARED の場合、送信側チャネルは共用です。

Fix shared。 送信チャネルは、その伝送キューに SHARED の処理があって CONNAME がブランクでない場合に共用されます。
DEFCDISP
プロパティー制御

(送信側チャネル、サーバー・チャネル、クラスター送信側チャネル、およびクラスター受信側チャネルでのみ)

メッセージに含まれるプロパティーの接頭部が mcd.jms.usr.、 または mqext. メッセージがリモート・キュー・マネージャーに送信される前に、メッセージ記述子 (または拡張) 内のものを除き、すべてのオプション・メッセージ・プロパティー (サポート値は MQPD_SUPPORT_OPTIONAL) が、メッセージ・データ内の 1 つ以上の MQRFH2 ヘッダーに入れられます。 そうでなければ、メッセージ記述子 (または拡張) に含まれているプロパティー以外のすべてのメッセージ・プロパティーがメッセージから除去されてから、メッセージがリモート・キュー・マネージャーに送信されます。

プロパティー記述子の「サポート」フィールドが MQPD_SUPPORT_OPTIONAL に設定されていないプロパティーがメッセージに含まれていると、そのメッセージは拒否され、レポート・オプションの設定に基づいて処理されます。 プロパティー記述子の「サポート」フィールドが MQPD_SUPPORT_OPTIONAL に設定されていても、プロパティー記述子の他のフィールドがデフォルト以外の値に設定されているプロパティーがメッセージに 1 つ以上含まれていると、メッセージからそれらのプロパティーが除去されてから、メッセージがリモート・キュー・マネージャーに送信されます。

「なし」は、メッセージ記述子 (または拡張) に含まれているプロパティー以外のすべてのメッセージ・プロパティーがメッセージから除去されてから、メッセージがリモート・キュー・マネージャーに送信されることを意味します。 プロパティー記述子の「サポート」フィールドが MQPD_SUPPORT_OPTIONAL に設定されていないプロパティーがメッセージに含まれていると、そのメッセージは拒否され、レポート・オプションの設定に基づいて処理されます。

PROPCTL
共有会話

(サーバー接続チャネルおよびクライアント接続チャネルのみ)

特定の TCP/IP クライアント・チャネル・インスタンス (ソケット) を通じて共有可能な会話の最大数を指定します。 指定できる値は以下のとおりです。
0: TCP/IP ソケットを通じた会話の共有ができないことを指定します。 チャネル・インスタンスは、以下の点に関して、 IBM WebSphere® MQ 7.0より前のモードで実行されます。
  • 管理者の停止と静止
  • ハートビート中
  • 先読み

1: TCP/IP ソケットを通じた会話の共有ができないことを指定します。 MQGET 呼び出しであるかどうかにかかわらず、クライアントのハートビートおよび先読みが可能であり、チャネル静止がさらに制御しやすくなります。

2 から 999999999: 共有される会話の数。 デフォルト値は 10 です。

クライアント接続の SHARECNV 値とサーバー接続の SHARECNV 値が一致しない場合、低い方の値が使用されます。
SHARECNV
未処理リセット・シーケンス番号

これは未解決要求からの順序番号であり、ユーザーの RESET CHANNEL コマンド要求が未解決であることを示します。 値がゼロなら、未解決の RESET CHANNEL がないことを示します。 値の範囲は 1 から 999999999 です。

RESETSEQ の値が 0 の場合、DISPLAY CHANNEL コマンドは RESETSEQ(NO) を返します。

RESETSEQ
送達不能キューを使用

(クライアント接続チャネル、サーバー接続チャネル、または Telemetry チャネルでは未使用)

チャネルでメッセージを配信できない場合に、送達不能キューを使用するかどうかを指定します。 指定可能な値は以下の 2 つです。
  • 「いいえ」 は、チャネルによって配信できないメッセージは障害として扱われ、チャネルは 非持続メッセージ速度の設定に従って終了するか、またはメッセージを廃棄することを意味します。
  • 「はい」 は、キュー・マネージャーの 「送達不能キュー」 プロパティーに送達不能キューの名前が指定されている場合に、そのキューが使用されることを意味します。 そうでない場合は、「いいえ」と同じ動作になります。
USEDLQ
ポート

(AMQP チャネルのみ)

AMQP 接続のポートを指定します。 AMQP 1.0 接続のデフォルト・ポートは 5672 です。 ポート 5672 を既に使用している場合は、異なるポートを指定できます。 PORT
クライアント ID を使用

(AMQP チャネルのみ)

AMQP チャネルの接続でクライアント ID を使用するように指定します。 Yes または Noに設定されます。 USECLTID
AMQP キープアライブ

(AMQP チャネルのみ)

キープアライブ時間をミリ秒単位で指定します。 AMQPKAプロパティがAutoの場合、ネゴシエートされたハートビート間隔値に基づいた値が使用される。

AMQP クライアントがキープアライブ間隔内にフレームを送信しなかった場合、接続は次のものでクローズされます。amqp:resource-limit-exceededAMQP エラー条件。

AMQPKA
トピック・ルート

(AMQP チャネルのみ)

AMQP チャネルのトピック・ルートを指定します。 このプロパティーを使用して、 MQ Light アプリケーションがキュー・マネージャーにデプロイされたときに、他のアプリケーションによって使用されているトピック・ツリーの領域との間でメッセージのパブリッシュやサブスクライブを行わないようにします。

TPROOT のデフォルト値は SYSTEM.BASE.TOPIC です。 このデフォルト値を使用すると、AMQP クライアントがパブリッシュ/サブスクライブのために使用するトピック・ストリングには接頭部が付かず、そのクライアントは、他の MQ パブリッシュ/サブスクライブ・アプリケーションとの間でメッセージを交換できるようになります。

TPROOT
一時モデル・キュー

(AMQP チャネルのみ)

一時キューの作成中に使用するモデル・キューの名前を指定します (最大長 48 文字)。

デフォルトは、SYSTEM.DEFAULT.MODEL.QUEUE です。

TMPMODEL
一時キュー接頭部

(AMQP チャネルのみ)

一時キュー名を派生させるときにモデル・キューの先頭に追加する一時キューの名前接頭部 (最大長 32 文字)。

デフォルトは AMQP.* です。

TMPQPRFX
[z/OS]セキュリティー・ポリシーの保護 これは、AMS 保護ポリシーの適用に関して、伝送キューからメッセージを取得するとき、またはターゲット・キューに書き込むときのメッセージ・チャネル・エージェントの動作を定義します。
これはタイプが sender、server、receiver、および requester のチャネルに対して有効です。 指定できる値は以下のとおりです。
パススルー
このチャネルでメッセージング・チャネル・エージェントが送受信するメッセージを変更なしでパススルーします。
この値は、チャネル・タイプが sender、server、receiver、または requester のチャネルに対して有効です。これがデフォルト値です。
除去
メッセージ・チャネル・エージェントが伝送キューから受け取ったメッセージの AMS 保護を解除し、そのメッセージをパートナーに送信します。
MCA が伝送キューからメッセージを受信するときに、伝送キューに AMS ポリシーが定義されている場合、 チャネル間でメッセージを送信する前に、メッセージから AMS 保護を解除するために適用されます。 伝送キューに AMS ポリシーが定義されていない場合、メッセージはそのまま送信されます。
この値は、チャネル・タイプが sender または server のチャネルに対してのみ有効です。
ポリシーを適用
ターゲット・キューに定義されたポリシーに基づいて、インバウンド・メッセージに AMS 保護を適用してからターゲット・キューに書き込まれるようにします。
メッセージ・チャネル・エージェントがインバウンド・メッセージを受信するときに、ターゲット・キューに AMS ポリシーが定義されている場合、メッセージがターゲット・キューに書き込まれる前に、AMS 保護がメッセージに適用されます。 ターゲット・キューに AMS ポリシーが定義されていない場合、メッセージはそのままターゲット・キューに書き込まれます。
この値は、チャネル・タイプが receiver または requester のチャネルに対してのみ有効です。
SPLPROT

「MCA」ページ

下の表には、 「チャネル・プロパティー」 ダイアログの 「MCA」 ページで設定するプロパティーがリストされています。 このチャネル用の Message Channel Agent (MCA) の実行方法を構成するには、「MCA」ページ上でプロパティーを編集します。

Property 意味 MQSC パラメーター
MCA ユーザー ID メッセージ・チャネル・エージェント・ユーザー ID。 非ブランクの場合は、メッセージ・チャネル・エージェントが IBM MQ リソースへのアクセスを許可するために使用するユーザー ID です。これには、受信側チャネルまたは要求側チャネルの宛先キューにメッセージを書き込むための許可 (PUTAUT が DEF の場合) が含まれます。
ブランクの場合、メッセージ・チャネル・エージェントはデフォルトのユーザー ID を使用します。 デフォルトのユーザー ID は、受信側チャネルを開始したユーザー ID から取られます。 指定できる値は以下のとおりです。
  • [z/OS]On z/OS, z/OS started-proceduresテーブルによってチャネルイニシエータ開始タスクに割り当てられたユーザID。
  • [UNIX、Linux、Windows、IBM i]TCP/IP on Multiplatforms の場合は、inetd.conf エントリのユーザー ID、またはリスナーを起動したユーザーです。
  • [UNIX、Linux、Windows、IBM i]SNA on Multiplatformsの場合は、SNAサーバーエントリーのユーザーID、または、これがない場合は、受信したアタッチリクエスト、または、リスナーを開始したユーザーです。
  • NetBIOS または SPX の場合、リスナーを始動したユーザー ID。
このストリングの最大長は、次のとおりです。
  • [Windows]64文字でWindows
  • Windows以外のプラットフォームの場合は 12 文字。

[Windows]On Windowsでは、オプションでuser@domainの形式でドメイン名でユーザー識別子を修飾することができる。

MCAUSER
MCA タイプ Message Channel Agent (MCA) プログラムをスレッドとして実行するように指定するには、「スレッド」を選択します。MCA をプロセスとして実行するように指定するには、「プロセス」を選択します。 MCATYPE
MCA 名 読み取り専用。 MCA 名は予約済みであり、必ずブランクに設定すべきなので、このプロパティーを編集することはできません。 MCANAME

「出口」ページ

下の表には、 「チャネル・プロパティー」 ダイアログの 「出口」 ページで設定するプロパティーがリストされています。 ユーザー出口を実行するようにチャネルを構成するには、「出口」ページでプロパティーを編集します。

Property 意味 MQSC パラメーター
送信出口名 「編集」をクリックして、「送信出口名の編集」ダイアログを開きます。 送信出口プログラムの名前を追加します。
  • [AIX][Linux]On AIX and Linux, enter names of one or more exit programs. すべての名前の最大合計長は、999 文字です。 使用する形式libraryname(functionname)ここで、名前の最大文字数は 128 です。
  • [Windows]On Windowsに、1つ以上の終了プログラムの名前を入力する。 すべての名前の最大合計長は、999 文字です。 使用する形式dllname(functionname)ここで、名前の最大文字数は 128 です。
  • [IBM i]On IBM iに、最大10個の終了プログラム名を入力する。 使用する形式programname libnameここで、 programname は最初の 10 文字を占め、 libname は 2 番目の 10 文字を占めます。 短い名前の場合は末尾にスペースを追加して、10 文字にします。
  • [z/OS]On z/OS, 最大8つの終了プログラム名を入力する。 ロード・モジュール名を使用します。この名前の最大文字数は 8 です。
  • その他のプラットフォーム上では、各チャネルごとに送信出口プログラムの名前を 1 つだけ指定することができます。
SENDEXIT
送信出口ユーザー・データ 送信出口プログラムの呼び出し時にチャネル送信出口に渡されるデータ (最大 32 文字) を入力します。
  • [AIX、Linux、Windows]On AIX, Linux, and Windowsに、1つ以上の終了プログラムのデータを入力する。 それぞれのデータはコンマで区切ります。 このフィールドの最大合計長は、999 文字です。
  • [IBM i]上のIBM iに、最大10個の文字列を、それぞれ32文字の長さで入力する。 データの最初のストリングは最初の送信出口に渡され、2 番目のストリングは 2 番目の出口に渡され、以下同様です。
  • [z/OS]z/OSに、それぞれ32文字の長さで、最大8つの文字列を入力する。 データの最初のストリングは最初の送信出口に渡され、2 番目のストリングは 2 番目の出口に渡され、以下同様です。
  • その他のプラットフォームでは、各チャネルに送信出口データのストリングを 1 つしか指定できません。
SENDDATA
受信出口名 「編集」をクリックして、「受信出口名の編集」ダイアログを開きます。 受信出口プログラムの名前を追加します。
  • [AIX][Linux]On AIX and Linux, enter names of one or more exit programs. すべての名前の最大文字総数は、999 文字です。 使用する形式libraryname(functionname)ここで、ストリングの最大文字数は 128 です。
  • [Windows]On Windowsに、1つ以上の終了プログラムの名前を入力する。 それぞれの名前はコンマで区切ります。 このフィールドの最大合計長は、999 文字です。 使用する形式dllname(functionname)ここで、ストリングの最大文字数は 128 です。
  • [Windows]Windowsに、最大10個の終了プログラム名を入力する。 それぞれの名前はコンマで区切ります。 使用する形式programname libnameここで、 programname は最初の 10 文字を占め、 libname は 2 番目の 10 文字を占めます。 短い名前の場合は末尾にスペースを追加して、10 文字にします。
  • [z/OS]On z/OSに、最大8つの終了プログラム名を入力する。 それぞれの名前はコンマで区切ります。 ロード・モジュール名を使用します。この最大文字数は 8 です。
  • その他のプラットフォーム上では、各チャネルごとに送信出口プログラムの名前を 1 つだけ指定することができます。
RCVEXIT
受信出口ユーザー・データ 受信出口プログラムの呼び出し時にチャネル受信出口に渡されるデータ (最大 32 文字) を入力します。
  • [AIX、Linux、Windows]On AIX, Linux, and Windowsに、1つ以上の終了プログラムのデータを入力する。 それぞれのデータはコンマで区切ります。 このフィールドの最大合計長は、999 文字です。
  • [IBM i]上のIBM iに、最大10個の文字列を、それぞれ32文字の長さで入力する。 データの最初のストリングは最初の受信出口に渡され、2 番目のストリングは 2 番目の出口に渡され、以下同様です。
  • [z/OS]z/OSに、それぞれ32文字の長さで、最大8つの文字列を入力する。 データの最初のストリングは最初の受信出口に渡され、2 番目のストリングは 2 番目の出口に渡され、以下同様です。
  • その他のプラットフォームでは、各チャネルに受信出口データのストリングを 1 つしか指定できません。
RCVDATA
セキュリティー出口名 セキュリティー出口プログラムの名前を入力します。
  • [AIX、Linux、Windows] AIX, Linux, and Windowsでは、以下の書式を使用するlibraryname(functionname)ここで、ストリングの最大文字数は 128 です。
  • [IBM i] IBM iでは、以下の書式を使用するprogramname libnameここで、 programname は最初の 10 文字を占め、 libname は 2 番目の 10 文字を占めます。 短い名前の場合は末尾にスペースを追加して、10 文字にします。
  • [z/OS]On z/OSでは、ロードモジュール名を使います。
SCYEXIT
セキュリティー出口ユーザー・データ チャネル・セキュリティー出口の呼び出し時にチャネル・セキュリティー出口に渡されるデータ (最大 32 文字) を入力します。 SCYDATA
メッセージ出口名 「編集」をクリックして、「メッセージ出口名の編集」ダイアログを開きます。 メッセージ出口プログラムの名前を追加します。
  • [AIX][Linux]On AIX and Linux, enter names of one or more exit programs. すべての名前の最大合計長は、999 文字です。 使用する形式libraryname(functionname)ここで、名前の最大文字数は 128 です。
  • [Windows]On Windowsに、1つ以上の終了プログラムの名前を入力する。 すべての名前の最大合計長は、999 文字です。 使用する形式dllname(functionname)ここで、名前の最大文字数は 128 です。
  • [IBM i]On IBM iに、最大10個の終了プログラム名を入力する。 使用する形式programname libnameここで、 programname は最初の 10 文字を占め、 libname は 2 番目の 10 文字を占めます。 短い名前の場合は末尾にスペースを追加して、10 文字にします。
  • [z/OS]On z/OS, 最大8つの終了プログラム名を入力する。 ロード・モジュール名を使用します。この名前の最大文字数は 8 です。
  • その他のプラットフォーム上では、各チャネルごとにメッセージ出口プログラムの名前を 1 つのみ指定できます。
MSGEXIT
メッセージ出口ユーザー・データ チャネル・メッセージ出口プログラムの呼び出し時にチャネル・メッセージ出口に渡されるデータ (最大 32 文字) を入力します。
  • [AIX、Linux、Windows]On AIX, Linux, and Windowsに、1つ以上の終了プログラムのデータを入力する。 それぞれのデータはコンマで区切ります。 このフィールドの最大合計長は、999 文字です。
  • [IBM i]IBM iに、最大10個の文字列を、それぞれ32文字の長さで入力する。 データの最初のストリングは最初のチャネル・メッセージ出口に渡され、2 番目のストリングは 2 番目の出口に渡され、以下同様です。
  • [z/OS]z/OSに、それぞれ32文字の長さで、最大8つの文字列を入力する。 データの最初のストリングは最初のチャネル・メッセージ出口に渡され、2 番目のストリングは 2 番目の出口に渡され、以下同様です。
  • その他のプラットフォーム上では、各チャネルごとにチャネル・メッセージ出口データのストリングを 1 つずつしか指定できません。
MSGDATA

「LU6.2」ページ

下の表には、 「チャネル・プロパティー」 ダイアログの LU6.2 ページで設定するプロパティーがリストされています。 チャネルが LU 6.2 トランスポート・プロトコルを使用する場合は、「LU6.2」ページ上で プロパティーを編集します。

Property 意味 MQSC パラメーター
モード名 LU 6.2 モード名を入力します。これは、「一般」 ページの Connection name プロパティーの値にサイド・オブジェクトが含まれていない限り、SNA モード名です。含まれている場合は、Mode name 値はブランクのままにしてください。 最大長は 8 文字です。 MODENAME
TP 名 リンクの遠端で実行される MCA プログラムの名前または総称名を入力します。 TPNAME
ユーザー ID リモート MCA との保護 LU 6.2 セッションを開始しようとするときに、MCA が使用するユーザー ID を入力します。 最大長は 12 文字ですが、使用されるのは最初の 10 文字のみです。 ユーザー ID
パスワード 「チャネル・パスワードの変更」をクリックして、「パスワードの変更」ダイアログに、リモート MCA との保護 LU 6.2 セッションを開始しようとするときに、MCA が使用するパスワードを入力します。 最大長は 12 文字です。 PASSWORD

「再試行」ページ

下の表には、 「チャネル・プロパティー」 ダイアログの 「再試行」 ページで設定するプロパティーがリストされています。 チャネルがリモート・キュー・マネージャーに接続できない場合のチャネルの動作方法を構成する には、「再試行」ページでプロパティーを編集します。

Property 意味 MQSC パラメーター
短期再試行カウント チャネルがリモートキューマネージャへの接続を試みることができる最大回数を 0 - 9999999 (z/OSCICS を使用している場合は、1 - 999999999)と入力します。 SHORTRTY
短期再試行間隔 短期再試行カウント時に、リモート・キュー・マネージャーへの接続の再試行をチャネルが待機する概算間隔を、秒単位で入力します。 0 の値は、チャネルが即時に再試行することを意味します。 SHORTTMR
長期再試行カウント 0 から 999999999 の範囲で、チャネルがリモート・キュー・マネージャーに接続を試行できる最大回数を入力します。 このプロパティーの値は、Short retry count プロパティーで指定されたカウントが使い果たされ、チャネルがまだリモート・キュー・マネージャーに正常に接続されていない場合にのみ使用されます。 LONGRTY
長期再試行間隔 長期再試行カウント時に、リモート・キュー・マネージャーへの接続の再試行をチャネルが待機する概算間隔を、秒単位で入力します。 0 の値は、チャネルが即時に再試行することを意味します。 LONGTMR
キープアライブ間隔 Keep alive interval プロパティーの値は、チャネルのタイムアウト値を指定します。 キープアライブ値が、ネゴシエーションされた「ハートビート間隔」の値に基づくようにするには、「自動」を選択します。 ネゴシエーションされたハートビート間隔がゼロより大きい場合、Keep alive interval は、ネゴシエーションされたハートビート間隔に 60 秒を加算した値になります。ネゴシエーションされたハートビート間隔がゼロであれば、Keep alive interval もゼロになります。 タイムアウト値を指定するには、0 から 99999 の範囲で秒数を入力します。 このチャネルのキープアライブを使用不可にするには、0 を入力します。 KAINT

「メッセージ再試行」ページ

下の表には、 「チャネル・プロパティー」 ダイアログの 「メッセージ再試行」 ページで設定するプロパティーがリストされています。 チャネルがリモート・キューにメッセージを初回に書き込んだときに失敗した場合のチャネルの動作方法を構成するには、「メッセージ再試行」ページでプロパティーを編集します。

Property 意味 MQSC パラメーター
メッセージ再試行カウント チャネルがリモート・キューへのメッセージの配信は不可能であると判断するまで、メッセージの配信を再試行する回数を 0 から 999999999 の範囲で入力します。 このプロパティーは、Message retry exit name プロパティーがブランクである場合のみ、MCA のアクションを制御します。 Message retry exit name プロパティーがブランクではない場合、Message retry count プロパティーの値は出口が使用するためにその出口に渡されますが、チャネルがメッセージの送信を再試行する回数は、Message retry count プロパティーではなく、その出口によって制御されます。 MRRTY
メッセージ再試行間隔 チャネルがリモート・キューにメッセージの書き込みを再試行するまでに待機する最小時間を、ミリ秒単位で入力します。 MRTMR
メッセージ再試行出口名 チャネル・メッセージ再試行出口プログラムの名前を入力します。
  • [AIX][Linux]AIX and Linuxでは、以下の書式を使用するlibraryname(functionname)ここで、ストリングの最大文字数は 128 です。
  • [Windows] Windowsでは、以下の書式を使用するdllname(functionname)ここで、ストリングの最大文字数は 128 です。
  • [IBM i] IBM iでは、以下の書式を使用するprogramname libnameここで、 programname は最初の 10 文字を占め、 libname は 2 番目の 10 文字を占めます。 短い名前の場合は末尾にスペースを追加して、10 文字にします。
  • [z/OS]On z/OSでは、ロードモジュール名を使います。
MRDATA
メッセージ再試行出口ユーザー・データ チャネル・メッセージ再試行出口の呼び出し時にチャネル・メッセージ再試行出口に渡されるデータ (最大 32 文字) を入力します。 MREXIT

「クラスター」ページ

下の表には、「チャネル・プロパティー」ダイアログの「クラスター」ページで設定するプロパティーがリストされています。 1 つ以上のクラスターでチャネルを共用するには、「クラスター」ページでプロパティーを編集します。
注: ターゲット・キュー・マネージャーのクラスター受信側チャネルのクラスター・チャネル・プロパティーを指定してください。 一致するクラスター送信側チャネルで指定するプロパティーすべては、無視される可能性が高くなります。 IBM Documentationクラスターチャンネル を参照。
Property 意味 MQSC パラメーター
クラスター内で共用しない デフォルトでは、このオプションが選択されており、チャネルはどのクラスターでも共用されません。 適用外
クラスター内で共用 1 つのクラスター内でチャネルを共用するには、このオプションを選択して、クラスターの名前を入力します。 プロパティー・ダイアログのストリングを参照してください。 クラスター
クラスターのリスト内で共用 複数のクラスターでチャネルを共用するには、このオプションを選択して、クラスターの名前が含まれている名前リスト・オブジェクトの名前を入力します。 プロパティダイアログの文字列を参照してください。 CLUSNL
ネットワーク優先順位 このプロパティーの値は、ネットワーク接続のチャネル優先順位を示します。 0 から 9 の範囲で値を入力します。0 が最低優先順位です。 IBM DocumentationNETPRTYチャンネル属性を参照 NETPRTY
CLWL チャネル・ランク 0 から 9 の範囲で、クラスター内のチャネルのランクを入力します。0 が最低優先順位です。 IBM DocumentationCLWLRANKチャンネル属性を参照 CLWLRANK
CLWL チャネル優先順位 0 から 9 の範囲で、クラスター内のチャネルの優先順位を入力します。0 が最低ランクです。 IBM DocumentationCLWLPRTYチャンネル属性を参照 CLWLPRTY
CLWL チャネル・ウェイト チャネルに適用される加重を入力します。これによってチャネルを介して送信されるメッセージの比率を制御します。 値は 1 から 99 の範囲でなければなりません。1 は最低の加重です。 IBM DocumentationCLWLWGHTチャンネル属性を参照 CLWLWGHT

「SSL」ページ

下の表には、「チャネル・プロパティー」ダイアログの「SSL」ページで設定するプロパティーがリストされています。 SSL セキュリティーを使用するようにチャネルを構成するには、「SSL」ページでプロパティーを編集します。

Property 意味 MQSC パラメーター
CertificateLabel 使用するこのチャネルの証明書ラベル。 ラベルにより、鍵リポジトリーに含まれているどの個人証明書をリモート・ピアに送信するかを指定します。 このプロパティーをブランクにした場合、証明書はキュー・マネージャーの CertificateLabel プロパティーによって判別されます。 CERTLABL
CipherSpec TLS 接続の CipherSpec の名前を入力します (最大で 32 文字)。 IBM MQ IBM MQ SSL チャネル定義の両端に対して、CipherSpec プロパティーに同じ値が指定されている必要があります。 詳しくは、IBM Documentationチャンネルの定義 の SSLCIPH プロパティを参照してください。

このパラメーター値は、チャネル状況属性ページの出力フィールドである、セキュリティー・プロトコル・プロパティーの値を設定するときにも使用されます。

SSLCIPH
接続を開始する相手先の認証 チャネルが必ず TLS クライアントからの TLS 証明書を受け取って認証するように指定するには、「必須」を選択します。チャネルが TLS クライアントからの TLS 証明書を受け取って認証する必要がない場合は、「オプション」を選択します。「オプション」を選択した場合、ピア TLS クライアントが証明書を送信すると、チャネルは証明書を通常どおり認証します。 SSLCAUTH
ピア発行者名 証明書発行者の識別名フィルター。 このフィールドには、リモート・ピア個人証明書の発行者 DN に一致する識別名フィルターが含まれます。 「ピア発行者名」は「SSL ピア・マップ」のキー・フィールドです。つまり、インバウンドチャネル接続の権限レコードのマッチングに使用されます。 SSLCERTI
これらの値と一致する識別名を持つ証明書のみを受け入れ る IBM MQ チャネルの相手側にあるピア・キュー・マネージャーまたはクライアントからの証明書の識別名の値を入力します。 チャネルが開始するときに、このプロパティーの値は、証明書の識別名と比較されます。 SSLPEER
これらの値と一致する識別名を持つ証明書のみを受け入れ る このチャネル認証レコードは、TLS 識別名 (DN) を MCAUSER 値にマップします。 SSLPEERMAP パラメーターは、SSLPEER と共に指定する必要があります。 SSLPEERMAP

「ロード・バランシング」ページ

下の表には、「チャネル・プロパティー」ダイアログの「ロード・バランシング」 ページで設定するプロパティーがリストされています。

Property 意味 MQSC パラメーター
ウェイト クライアント・チャネル加重プロパティーでは、どのクライアント接続チャネル定義を使用するかを制御するための加重値を指定します。 クライアント・チャネル加重プロパティーを使用すると、適切なクライアント・チャネル定義が複数存在する場合に、それぞれの加重値に基づいてクライアント・チャネル定義をランダムに選択できるようになります。

クライアントがキュー・マネージャー・グループへの接続を要求する MQCONN を実行するときに、先頭にアスタリスクを付けてキュー・マネージャーを指定した場合、クライアント・チャネル定義テーブル (CCDT) に適切なチャネル定義が複数存在すれば、加重値に基づいて定義が選択され、使用されることになります。つまり、該当する CLNTWGHT(0) の定義がアルファベット順で最初に選択されます。 0 から 99 の範囲の値を指定します。 デフォルトは 0 です。 値として 0 を指定すると、ロード・バランシングが実行されず、該当する定義がアルファベット順で選択されます。 ロード・バランシングを有効にするには、1 から 99 までの範囲の値を選択します (1 が最低の加重値、99 が最高の加重値です)。 ゼロ以外の加重値が設定されている 2 つ以上のチャネルの間でメッセージが配分される比率は、それぞれの加重値の比率にほぼ比例することになります。

CLNTWGHT
アフィニティー チャネル・アフィニティー・プロパティーを使用すると、同じキュー・マネージャー名を使用して複数回接続するクライアント・アプリケーションが、接続ごとに同じクライアント・チャネル定義を使用するかどうかを選択することが可能になります。 このプロパティーは、該当するチャネル定義が複数存在する場合に使用します。 指定できる値は以下のとおりです。

優先. これがデフォルト値です。 クライアント・チャネル定義テーブル (CCDT) を読み取るプロセスの最初の接続によって、該当する定義のリストが作成されます。そのリストは、クライアント・チャネル・ウェイトの値に基づいています。ウェイトの値が 0 の定義が先頭に来て、各定義がアルファベット順で並びます。 プロセス内の各接続は、リスト内の最初の定義を使用して接続を試行します。 接続が失敗した場合は、次の定義が使用されます。 失敗した定義のうち、クライアント・チャネル・ウェイトの値が 0 以外の定義は、リストの末尾に移動します。 クライアント・チャネル・ウェイトの値が 0 の定義は、リストの先頭に残り、各接続で最初に選択されます。 同じホスト名を持つ各クライアント・プロセスは、同じリストを作成します。

「なし」。 CCDT を読み取るプロセス内の最初の接続が、適用可能な定義のリストを作成します。 プロセス内のすべての接続が、クライアント・チャネル・ウェイトの値に基づいて該当する定義を選択します。アルファベット順で、ウェイトの値が 0 の定義を最初に選択します。

AFFINITY

「統計」ページ

下の表には、「チャネル・プロパティー」ダイアログの「統計」ページで設定する属性がリストされています。 モニター・データまたは統計データを収集するようにチャネルを構成するには、統計 ページでプロパティーを編集します。

Property 意味 MQSC パラメーター
変更日 読み取り専用。 キューのプロパティーが最後に変更された日付です。 ALTDATE
変更時刻 読み取り専用。 キューのプロパティーが最後に変更された時刻です。 ALTTIME
チャネル・モニター チャネルの現在のパフォーマンスに関するオンライン・モニター・データを収集するように IBM MQ を構成できます。 キューマネージャのChannel monitoringプロパティ(キューマネージャのプロパティを参照)の値を継承するには、キューマネージャをクリックします。 キュー・マネージャーの Channel monitoring プロパティーが None の場合、キューの Channel monitoring プロパティーは無視されます。 キュー・マネージャーの Channel monitoring 属性が None ではない場合、キュー・マネージャー設定をオーバーライドして、このチャネルのデータが収集されないようにするには、「オフ」をクリックします。また、低速でデータを収集するには「低」を、中程度の速度でデータを収集するには「中」を、高速でデータを収集するには「高」をクリックします。 MONCHL
チャネル統計 チャネルのアクティビティーに関する統計データを収集するように IBM MQ を構成できます。 キュー・マネージャーの Channel statistics プロパティーの値 (キュー・マネージャー・プロパティーを参照) を継承するには、「キュー・マネージャー」をクリックします。 キュー・マネージャーの Channel statistics プロパティーが None の場合、キューの Channel statistics プロパティーは無視されます。 キュー・マネージャーの Channel statistics 属性が None ではない場合、キュー・マネージャー設定をオーバーライドして、このチャネルのデータが収集されないようにするには、「オフ」をクリックします。また、低速でデータを収集するには「低」を、中程度の速度でデータを収集するには「中」を、高速でデータを収集するには「高」をクリックします。 STATCHL