チャネル・プロパティー

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

下の表には、設定できるすべての属性がリストされています。

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

それぞれの属性について、その構成時に必要となる簡単な説明を記載しています。また、表には、ALTER CHANNEL および DISPLAY CHANNEL コマンド用の同等の MQSC パラメーターも記載してあります。 MQSC コマンドについて詳しくは、オンラインの IBM® MQ 製品資料で『スクリプト (MQSC) コマンド』を参照してください。

「一般」ページ

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

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

クラスター送信側チャネル: 手動で定義されたクラスター送信側チャネルの「ローカル通信アドレス」フィールドに値を入力する場合、この値は、フル・リポジトリー・キュー・マネージャーによって接続が確立されたときにフル・リポジトリーのクラスター受信側チャネルの値で上書きされます。 手動で定義されたクラスター送信側チャネルでの値の指定と同様に、チャネルの自動定義出口を 書き込んで、「ローカル通信アドレス」属性の値が自動的に定義されたクラスター送信側チャネルになるようにします。

クラスター受信側チャネル: すべてのキュー・マネージャーが同じコンピューター上にない場合は、IP アドレスをクラスター受信側チャネルの「ローカル通信アドレス」フィールドに書き込まないでください。これは、クラスター受信側チャネルの「ローカル通信アドレス」フィールドの IP アドレスを使用して キュー・マネージャーに接続するキュー・マネージャーは、自動定義のクラスター送信側チャネルに伝搬した値を持っているためです。ただし、クラスター内のすべてのキュー・マネージャーでアウトバウンド通信に特定のポートまたはポート範囲が使用されるようにする場合は、クラスター受信側チャネルの「ローカル通信アドレス」フィールドにポート番号またはポート範囲を書き込みます。

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

「拡張」ページ

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

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

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

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

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

「最大インスタンス数」として、現在実行されているサーバー接続チャネルのインスタンス数よりも小さい値を設定すると、既存のインスタンスのうち、十分な数のインスタンスが停止するまでは、新しいインスタンスの開始が禁止されます。

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

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

このパラメーターは、サーバー接続チャネルで使用します。「クライアントあたりの最大インスタンス数」では、1 つのクライアントから開始できる個々のサーバー接続チャネルの同時インスタンスの最大数を指定します。このコンテキストでは、同じリモート・ネットワーク・アドレスからの接続が、同じクライアントからの接続と見なされます。

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

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

「最大インスタンス数」「クライアントあたりの最大インスタンス数」とは異なります。「最大インスタンス数」は接続の最大数ですが、「クライアントあたりの最大インスタンス数」は、各クライアントからサーバーに接続が許可されている、接続の最大数です。

MAXINSTC
キープアライブ間隔 0 から 99999 の範囲でキープアライブ間隔の長さを入力します。チャネルが TCP または SPX 以外のトランスポート・タイプを使用する場合、この属性は無視されます。「TCP キープアライブ」属性は、「キュー・マネージャー」プロパティーの「チャネル」ページ「はい」に設定する必要があります。z/OS キュー・マネージャーの場合は、個々のチャネルのキープアライブ間隔を「キープアライブ間隔」属性で指定します。それ以外のプラットフォームのキュー・マネージャーの場合、「キープアライブ間隔」属性を使用するのは、チャネルを z/OS キュー・マネージャーに接続する場合に限られます。このため、「キープアライブ間隔」属性が備えている機能を使用するには、「キープアライブ間隔」属性を「自動」に設定して、ネゴシエーション済みハートビート間隔の値に基づいた値を使用します。 KAINT
シーケンス番号折り返し シーケンス番号は、チャネルを介して送信されたメッセージのカウントです。 シーケンス番号は、チャネルを介してメッセージが送信されるたびに大きくなります。 100 から 999999999 (CICS® を使用する z/OS の場合は 1 から 999999999) の範囲のメッセージ・シーケンス番号の最大値を入力します。メッセージ番号はこの最大値に達すると 1 から再開します。値は、以前のメッセージでまだ使用中であるときにその番号が再発行されることがないように、十分に高い値にする必要があります。 チャネルの両端は、チャネルの始動時に同じシーケンス番号折り返し値を持っていなければなりません。そうでない場合は、エラーを受け取ります。 SEQWRAP
非持続メッセージ速度

チャネル上の非持続メッセージがトランザクション内で転送されないことを指定するには、「高速」を選択します。 これは、非持続メッセージが、トランザクションの一部である場合よりもはるかに高速に、検索に利用できるようになることを意味します。 ただし、非持続メッセージはトランザクションの一部でないため、例えばメッセージの転送中にチャネルが停止した場合に、メッセージが失われる可能性があります。 これが生じることを避けるには、「通常」を選択します。 NPMSPEED
バッチ・サイズ 同期点に達する前に送信されるメッセージの最大数を入力します。 メッセージは、常に個別に転送されますが、バッチとしてコミットまたはバックアウトされます。 デフォルトのバッチ・サイズである 50 を使用し、この値は必要な場合にのみ変更してください。 BATCHSZ
メッセージ圧縮 「編集」をクリックして、「メッセージ圧縮の編集」ダイアログを開きます。 チャネル定義でサポートされているメッセージの圧縮法を優先順に選択します。 チャネルのもう一方の終端でサポートされている最初の技法が使用されます。 「なし」は、メッセージの圧縮が行われないことを示します。 「RLE」は、ラン・レングス・エンコードを使用してメッセージ・データの圧縮を行うことを示します。 「ZLIBFAST」は、zlib 圧縮法を使用してメッセージ・データの圧縮を行うことを示し、この場合短時間で圧縮が行われます。 「ZLIBHIGH」は、zlib 圧縮法を使用してメッセージ・データの圧縮を行うことを示し、この場合高水準の圧縮が行われます。 「ANY」は、キュー・マネージャーでサポートされている任意の圧縮法を使用できることを示します。 詳しくは、オンラインの IBM MQ 製品資料で『分散キューイングとクラスター』 を参照してください。 COMPMSG
ヘッダー圧縮 「編集」をクリックして、「ヘッダー圧縮の編集」ダイアログを開きます。 チャネル定義でサポートされているヘッダーの圧縮法を優先順に選択します。 チャネルのもう一方の終端でサポートされている最初の技法が使用されます。 「なし」はヘッダーの圧縮を行わないことを、「システム」はヘッダーの圧縮を行うことをそれぞれ示しています。 詳しくは、オンラインの IBM MQ 製品資料で『分散キューイングとクラスター』 を参照してください。 COMPHDR
Batch interval (バッチ間隔) 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 つです。

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

「共用」。 受信チャネルは、キュー共用グループに向けられたインバウンド伝送への応答として開始された場合に共用されます。 送信チャネルは、その伝送キューに SHARED の処理がある場合に共用されます。

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

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

この属性では、V6 以前のキュー・マネージャーに送信されようとしているメッセージのプロパティーをどのように処理するかを定義します。呼び出し側に RFH2 を伝搬する V6 の動作を保持するには、値を「互換性」から「すべて」に変更する必要があります。 有効な値は以下のとおりです。

「すべて」は、メッセージをリモート・キュー・マネージャーに送信するときに、そのメッセージのすべてのプロパティーがメッセージに組み込まれることを意味します。メッセージ記述子 (または拡張) に含まれるものを除き、プロパティーはメッセージ・データ内の 1 つ以上の MQRFH2 ヘッダーに入れられます。

「互換性」。 これがデフォルト値です。JMS 関連プロパティーがメッセージ・データの MQRFH2 ヘッダーに含まれていることを前提とするアプリケーションは、変更なしで引き続き実行できます。

接頭部として、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
[V9.0.0.0 Jun 2016]ポート

(AMQP チャネルのみ)

[V9.0.0.0 Jun 2016]AMQP 接続のポートを指定します。 AMQP 1.0 接続のデフォルトのポートは 5672 です。 ポート 5672 が既に使用されている場合は、別のポートを指定することができます。 [V9.0.0.0 Jun 2016]PORT
[V9.0.0.0 Jun 2016]クライアント ID を使用

(AMQP チャネルのみ)

[V9.0.0.0 Jun 2016]AMQP チャネルの接続でクライアント ID を使用するように指定します。 「はい」または「いいえ」に設定されます。 [V9.0.0.0 Jun 2016]USECLTID
[V9.0.0.0 Jun 2016]AMQP キープアライブ

(AMQP チャネルのみ)

[V9.0.0.0 Jun 2016]キープアライブ時間を秒単位で指定します。キープアライブ間隔の間に AMQP クライアントがフレームを送信しないと、接続は amqp:resource-limit-exceeded AMQP エラー状態で閉じられます。 [V9.0.0.0 Jun 2016]AMQPKA
[V9.0.0.0 Jun 2016]トピック・ルート

(AMQP チャネルのみ)

[V9.0.0.0 Jun 2016]AMQP チャネルのトピック・ルートを指定します。この属性を使用して、キュー・マネージャーにデプロイした MQ Light アプリケーションが、他のアプリケーションによって使用されているトピック・ツリー内の領域でメッセージのパブリッシュ/サブスクライブを実行しないように設定します。

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

[V9.0.0.0 Jun 2016]TPROOT

「MCA」ページ

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

属性 意味 MQSC パラメーター
MCA ユーザー ID メッセージ・チャネル・エージェント・ユーザー ID。非ブランクの場合、メッセージ・チャネル・エージェントが IBM MQ リソースへのアクセス許可に使用するユーザー ID です。このアクセス許可には、(PUTAUT が DEF に設定されている場合に) 受信側チャネルまたは要求側チャネル用の宛先キューにメッセージを置くための許可も含まれます。
ブランクの場合、メッセージ・チャネル・エージェントはデフォルトのユーザー ID を使用します。デフォルトのユーザー ID は、受信側チャネルを開始したユーザー ID から取られます。有効な値は以下のとおりです。
  • z/OS では、z/OS の started procedures table によって、チャネル・イニシエーターで開始されたタスクに割り当てられたユーザー ID。
  • z/OS 以外の TCP/IP では、inetd.conf エントリーのユーザー ID、またはリスナーを開始したユーザーのユーザー ID。
  • z/OS 以外の SNA では、SNA サーバー・エントリーのユーザー ID。これがない場合は、着信添付要求のユーザー ID、またはリスナーを開始したユーザーのユーザー ID。
  • NetBIOS または SPX では、リスナーを開始したユーザー ID。
ストリングの最大長は、Windows では 64 文字、それ以外のプラットフォームでは 12 文字です。Windows ではオプションで、ドメイン名を使用して、user@domain の形式でユーザー ID を修飾できます。
MCAUSER
MCA タイプ Message Channel Agent (MCA) プログラムをスレッドとして実行するように指定するには、「スレッド」を選択します。MCA をプロセスとして実行するように指定するには、「プロセス」を選択します。 MCATYPE
MCA 名 読み取り専用。MCA 名は予約済みであり、必ずブランクに設定すべきなので、この属性を編集することはできません。 MCANAME

「出口」ページ

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

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

「LU6.2」ページ

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

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

「再試行」ページ

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

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

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

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

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

「クラスター」ページ

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

「SSL」ページ

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

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

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

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

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

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

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

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

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

AFFINITY

「統計」ページ

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

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

資料 資料

フィードバック

タイム・スタンプ・アイコン 最終更新: 2018 年 2 月 6 日 (火)
http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.mq.explorer.doc/com.ibm.mq.explorer.doc/e_properties_channels.htm