DEFINE CHANNEL

PREFERRED

クライアント・チャネル定義テーブル (CCDT) を読み取るプロセス内の最初の接続が、適用可能な定義のリストを作成します。 このリストは重み付けに基づいており、該当する CLNTWGHT (0) 定義が最初にアルファベット順に表示されます。 プロセス内の各接続は、リスト内の最初の定義を使用して接続を試行します。 接続が失敗した場合は、次の定義が使用されます。 失敗した非 CLNTWGHT (0) 定義は、リストの末尾に移動されます。 CLNTWGHT (0) 定義はリストの先頭に残り、接続ごとに最初に選択されます。 C、C++、および .NET (完全管理 .NETを含む) クライアントの場合、リストの作成後に CCDT が変更されると、リストが更新されます。 同じホスト名を持つ各クライアント・プロセスは、同じリストを作成します。

NONE

CCDT を読み取るプロセス内の最初の接続が、適用可能な定義のリストを作成します。 プロセス内のすべての接続は、最初にアルファベット順で選択された適用可能な CLNTWGHT (0) 定義を持つ加重に基づいて、適用可能な定義を選択します。 C、C++、および .NET (完全管理 .NETを含む) クライアントの場合、リストの作成後に CCDT が変更されると、リストが更新されます。

CHLNAME(A) QMNAME (QM1) CLNTWGHT(3)
CHLNAME(B) QMNAME (QM1) CLNTWGHT(4)
CHLNAME(C) QMNAME (QM1) CLNTWGHT(4)

プロセスの最初の接続により、加重に基づいて順序付けられた独自のリストが作成されます。 したがって、例えば、番号付きリスト CHLNAME(B), CHLNAME(A), CHLNAME(C)を作成することができます。

AFFINITY(PREFFERED) の場合、プロセス中、接続のたびに、CHLNAME(B) を使用して接続が試行されます。 接続に失敗すると、定義はリストの末尾に移動され、リストは CHLNAME(A), CHLNAME(C), CHLNAME(B)になります。 すると、プロセス中、接続のたびに、CHLNAME(A) を使用して接続が試行されます。

AFFINITY(NONE) の場合、プロセス中、接続のたびに、加重に基づいてランダムに選択された 3 つの定義のいずれかを使用して接続が試行されます。

会話の共有がゼロ以外のチャネル加重および AFFINITY(NONE) を指定して有効にされている場合、複数の接続が既存のチャネル・インスタンスを共有する必要はありません。 それらの接続は、既存のチャネル・インスタンスを共有しなくても、別々のアプリケーション定義を使用して同じキュー・マネージャー名に接続できます。

このパラメーターは、チャネル・タイプ (CHLTYPE) が AMQP のチャネルにのみ有効です。

バッチ・ハートビートを使用すると、メッセージをバッチでコミットする直前に、送信側チャネルは受信側チャネルがまだアクティブであるかを検査します。 受信側チャネルがアクティブでない場合は、バッチを通常の場合のように未確定にするのではなく、バックアウトすることができます。 バッチをバックアウトすることによって、メッセージは処理可能な状態にとどまるので、例えば、メッセージを別のチャネルにリダイレクトできます。

バッチ・ハートビート間隔内に、送信側チャネルに受信側チャネルからの通信を受信した場合、受信側チャネルはアクティブであると見なされます。 その他の場合、検査のために「ハートビート」が受信側チャネルに送信されます。

値は 0 から 999999 の範囲でなければなりません。 ゼロの値は、バッチ・ハートビートが使用されないことを示します。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR 、 SVR 、 CLUSSDR 、および CLUSRCVR であるチャネルにのみ有効です。

値は 0 から 999999999 の範囲でなければなりません。 0 は、伝送キューが空 (または BATCHSZ 限度に到達している) になった時点でバッチが終了することを意味します。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR 、 SVR 、 CLUSSDR 、および CLUSRCVR であるチャネルにのみ有効です。

同期点をとるまでに、1 つのチャネルを介して送信可能なデータ量 (キロバイト) の限度を指定します。 限度に達した際のメッセージがチャネルを通って送信された後に、同期点が取られます。 この属性の値がゼロの場合、それはこのチャネルに対するバッチに適用されるデータ限度がないことを意味します。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR 、 SVR 、 CLUSSDR 、および CLUSRCVR であるチャネルにのみ有効です。

値は 0 から 999999 の範囲でなければなりません。 デフォルト値は 5000 です。

このパラメーターは、すべてのプラットフォームでサポートされています。

NPMSPEED (FAST) チャネルを介して送信される非持続メッセージはキューに即時に (バッチの完了を待たずに) 配信されますが、それらのメッセージはそのチャネルのバッチ・サイズに加算されるので、BATCHSZ メッセージが流れると確認フローが発生します。

NPMSPEED が FAST に設定されていて、非持続メッセージのみ移動するときに、バッチ・フローがパフォーマンスに影響している場合には、BATCHSZ を最大許容値の 9999 に設定し、BATCHLIM をゼロに設定することを考慮してください。

さらに、BATCHINT を 999999999 などの大きな値に設定すると、伝送キュー上で待機している新しいメッセージがなくても、各バッチが「オープン」状態になる時間が長くなります。

上記のように設定すると確認フローの頻度は最小になりますが、このように設定してチャネルを介して持続メッセージを移動する場合に、これらの持続メッセージのみの配信の際に大幅な遅延が発生することに注意してください。

コミットされていないメッセージの最大数は、 ALTER QMGR コマンドの MAXUMSGS パラメーターによって指定されます。

値は 1 から 9999 の範囲でなければなりません。

使用するこのチャネルの証明書ラベル。

ラベルにより、鍵リポジトリーに含まれているどの個人証明書をリモート・ピアに送信するかを指定します。 この属性がブランクの場合、証明書はキュー・マネージャーのCERTLABLパラメーターによって決定されます。

リモート・ピアの IBM MQ バージョンが証明書ラベル構成を完全にサポートしており、チャネルが TLS CipherSpecを使用している場合、インバウンド・チャネル (受信側チャネル、クラスター受信側チャネル、非修飾サーバー・チャネル、およびサーバー接続チャネルを含む) は、構成された証明書のみを送信することに注意してください。

詳しくは、 楕円曲線と RSA の相互運用性 CipherSpecs を参照してください。

チャネルの CERTLABL に変更を加えた場合、REFRESH SECURITY TYPE(SSL) コマンドを実行する必要はありません。 ただし、キュー・マネージャーの CERTLABL に変更を加えた場合、REFRESH SECURITY TYPE(SSL) コマンドを実行する必要があります。

このパラメーターは、すべてのタイプのチャネルで必須です。 CLUSSDR チャネルでは、他のチャネル・タイプとは異なる形式をとることができます。 CLUSSDR チャネルの命名規則でキューマネージャの名前が含まれている場合、 CLUSSDR チャネルを + QMNAME + の構成を使用して定義できます。 CLUSRCVR チャンネルに接続した後、 IBM MQ は CLUSSDR チャンネル定義内の + QMNAME + の代わりに、正しいリポジトリ・キュー・マネージャ名を置換します。 この機能は AIX® HP-UX IBM i Linux、Solaris、およびWindows のみに適用されます。 クラスターのコンポーネントを参照してください。

この名前は、このキュー・マネージャー上で定義されている既存のチャネルの 名前と同じであってはなりません。ただし、REPLACE または ALTER が指定されている場合を除きます。 z/OS では、CLNTCONN チャネル名が他のものと重複してもかまいません。

ストリングの最大長は 20 文字で、有効な文字しか含めることができません。IBM MQ オブジェクトの命名規則を参照してください。

( z/OS を除くすべてのプラットフォーム)

SDR

送信側チャネル

SVR

サーバー・チャネル

RCVR

受信側チャネル

RQSTR

要求側チャネル

CLNTCONN

クライアント接続チャネル

SVRCONN

サーバー接続チャネル

CLUSSDR

CLUSSDR チャネル。

CLUSRCVR

Cluster-receiver channel.

AMQP

AMQP チャネル

特殊値 0 は、ランダムなロード・バランシングが実行されずに、適用可能な定義がアルファベット順に選択されることを示します。 ランダムなロード・バランシングを使用可能にするには、値を 1 から 99 の範囲で指定する必要があります。1 は最低加重、99 は最高加重です。

クライアント・アプリケーションがキュー・マネージャー名 * name を指定して MQCONN を発行すると、クライアント・チャネル定義をランダムに選択できます。 定義は、加重に基づいてランダムに選択されます。 該当する CLNTWGHT (0) 定義があれば、アルファベット順で最初に選択されます。 クライアント接続定義の選択におけるランダム性は保証されていません。

CHLNAME(TO.QM1) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address1) CLNTWGHT(2)
CHLNAME(TO.QM2) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address2) CLNTWGHT(4)

キュー・マネージャー名 *GRP1 のクライアント MQCONN は、チャネル定義の加重に基づいて、2 つの定義のいずれかを選択します。 (ランダムな整数が、1 から 6 の間で生成されます。 この整数が 1 から 2 の範囲である場合、address1 が使用され、それ以外の場合は address2 が使用されます)。 この接続が失敗すると、クライアントはもう 1 つの定義を使用します。

CCDT には、ゼロとゼロ以外の両方の加重を持つ適用可能な定義が含まれる可能性があります。 このような場合、ゼロの加重を持つ定義が最初に、アルファベット順に選択されます。 これらの接続が失敗した場合、ゼロ以外の加重を持つ定義が、加重に基づいて選択されます。

CHLNAME(TO.QM1) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address1) CLNTWGHT(1)
CHLNAME(TO.QM2) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address2) CLNTWGHT(2)
CHLNAME(TO.QM3) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address3) CLNTWGHT(0)
CHLNAME(TO.QM4) CHLTYPE(CLNTCONN) QMNAME(GRP1) CONNAME(address4) CLNTWGHT(0)

キュー・マネージャー名 *GRP1 のクライアント MQCONN は、最初に定義 TO.QM3を選択します。 この接続が失敗すると、クライアントは次に定義 TO.QM4 を選択します。 この接続も失敗した場合、クライアントは次に残る 2 つの定義のいずれかを、加重に基づいて選択します。

CLNTWGHT は、すべてのトランスポート・プロトコルでサポートされています。

このパラメータは、チャンネルタイプ（ CHLTYPE ）が CLUSSDR および CLUSRCVR チャンネルのチャンネルのみに有効です。 CLUSTER または CLUSNL の結果の値のうち、ブランク以外の値にできるのは片方だけです。もう一方はブランクにする必要があります。

このパラメータは、チャンネルタイプ（ CHLTYPE ）が CLUSSDR および CLUSRCVR チャンネルのチャンネルのみに有効です。 CLUSTER または CLUSNL の結果の値のうち、ブランク以外の値にできるのは片方だけです。もう一方はブランクにする必要があります。

このパラメータは、チャンネルタイプ（ CHLTYPE ）が CLUSSDR および CLUSRCVR チャンネルのチャンネルのみに有効です。

この属性の詳については、 CLWLPRTY チャネル属性を細参照してください。

このパラメータは、チャンネルタイプ（ CHLTYPE ）が CLUSSDR および CLUSRCVR チャンネルのチャンネルのみに有効です。

この属性の詳については、 CLWLRANK チャネル属性を細参照してください。

このパラメータは、チャンネルタイプ（ CHLTYPE ）が CLUSSDR および CLUSRCVR チャンネルのチャンネルのみに有効です。

この属性について詳しくは、 CLWLWGHT チャネル属性を参照してください。

CLUSRCVR チャネルの場合、CONNAME はローカル・キュー・マネージャーに関連し、その他のチャネルの場合、接続名はターゲット・キュー・マネージャーに関連します。

z/OS では、 は チャンネルに必須です。 CONNAME CLUSRCVR それに加えて、CONNAME を指定する場合と、自動的に生成された名前を使用する場合のどちらでも、生成される CONNAME はローカル・キュー・マネージャーの有効な接続名でなければなりません。そうでないと、フル・リポジトリーはローカル・キュー・マネージャーへの接続を行うことができません。

z/OSでは、ストリングの最大長は 48 文字です。

分散プラットフォームでは、ストリングの最大長は 264 文字です。

CONNAME を、指定された TRPTYPE のマシンの名前のコンマ区切りリストとして指定します。 通常、必要なマシン名は 1 つだけです。 複数のマシン名を指定して、同じプロパティーで複数の接続を構成することができます。 接続は、通常は正常に確立されるまで、接続リストに指定された順序で試行されます。 CLNTWGHT 属性が指定されている場合、クライアントの順序が変更されます。 どの接続も成功しなかった場合、チャネルの属性によって決められたとおりに、チャネルは再接続を試みます。 クライアント・チャネルでは、キュー・マネージャー・グループの代わりに、接続リストを使用して複数接続を構成することができます。 メッセージ・チャネルでは、複数インスタンス・キュー・マネージャーの代替アドレスへの接続を構成するために、接続リストが使用されます。

CONNAME は、チャネル・タイプ (CHLTYPE) が SDR、RQSTR、CLNTCONN、 および CLUSSDR のチャネルでは必須です。 SVR チャンネル、および CLUSRCVR チャンネルの TRPTYPE(TCP) ではオプションであり、 RCVR または SVRCONN チャンネルでは無効です。

複数の接続名をリストに指定することは、 IBM WebSphere® MQ 7.0.1で初めてサポートされました。 このことにより、CONNAME パラメーターの構文が変更されます。 以前のクライアントおよびキュー・マネージャーは、リスト内の最初の接続名を使用して接続し、リスト内の残りの接続名は読み取りません。 以前のクライアントやキュー・マネージャーが新しい構文を解析できるようにするために、リスト内の最初の接続名にポート番号を指定してください。 ポート番号を指定することで、 IBM WebSphere MQ 7.0.1より前のレベルで稼働しているクライアントまたはキュー・マネージャーからチャネルに接続する際の問題を回避できます。

(1415)

NO

送信側による変換なし。

YES

送信側による変換。

z/OS では、 と は と の同義語として受け入れられます。 N Y NO YES

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、CLUSSDR、 または CLUSRCVR のチャネルにのみ有効です。

PRIVATE

このチャネルは、専用チャネルとして属性指定されることが意図されています。

FIXSHARED

このチャネルは、特定のキュー・マネージャーと関連付けられた共有チャネルとして属性指定されることが意図されています。

SHARED

このチャネルは、共有チャネルとして属性指定されることが意図されています。

このパラメーターは、チャネル・タイプ (CHLTYPE) が CLNTCONN、CLUSSDR、または CLUSRCVR であるチャネルには適用されません。

NO

MQCONNXによってオーバーライドされない限り、クライアントは自動的に再接続されません。

YES

MQCONNXによってオーバーライドされない限り、クライアントは自動的に再接続します。

QMGR

MQCONNX でオーバーライドされない限り、 クライアントは、同じキュー・マネージャーに対してのみ自動的に再接続します。 QMGR オプションは MQCNO_RECONNECT_Q_MGRと同じ効果があります。

DISABLED

MQCONNX MQI 呼び出しを使用してクライアント・プログラムによって要求された場合でも、再接続は無効になります。

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

値は 0 から 999 999 の範囲でなければなりません。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SVRCONN, SDR、SVR、CLUSSDR、CLUSRCVR のチャネルにのみ有効です。

TCP プロトコルを使用する SVRCONN チャネルの場合、DISCINT の解釈は異なります。 この場合は、パートナー・クライアントからの通信が何もないときに、SVRCONN インスタンスがアクティブ状態を保つ最小時間 (秒単位) です。 値を 0 にすると、この切断処理は無効になります。 SVRCONN の非アクティブ期間は、クライアントからの IBM MQ APIコールの間のみに適用されるため、待機コールを含む延長された MQGET の間、クライアントが切断されることはありません。 この属性は、TCP 以外のプロトコルを使用する SVRCONN チャネルでは無視されます。

HBINT は、メッセージ・チャネル・エージェント (MCA) によって送信されるハートビート・フローの間隔時間の概算値を指定します。 このフローは、伝送キューにメッセージがないときに送信されます。

ハートビート・フローは、メッセージの到着または切断インターバルの満了を待機している受信 MCA を非ブロック化します。 受信 MCA が非ブロック化された場合には、そこで切断インターバルが満了するのを待たずにチャネルを切断することができます。 ハートビート・フローは、また、大きなメッセージのために割り振られているすべてのストレージ・バッファーを解放します。 また、チャネル受信終了時に開いたままになっているキューがあれば、そのキューを閉じます。

値は秒単位であり、範囲は 0 から 999999 でなければなりません。 値 0 は、ハートビート・フローが送信されないことを意味します。 デフォルト値は 300 です。 最大限活用するには、この値が切断インターバル値より低いものでなければなりません。

SVRCONN チャネルおよび CLNTCONN チャネルでは、 ハートビートはサーバー・サイドおよびクライアント・サイドの両方から個々に 流れることがあります。 ハートビート間隔の間にチャネルを通してデータが転送されないと、CLNTCONN MQI エージェントはハートビート・フローを送信します。 SVRCONN MQI エージェントは、それに対してハートビート・フローを送り返して応答します。 これらのフローは、チャネルの状態に関係なく送信されます。 例えば、API 呼び出しの作成中にチャネルが活動状態でなくても、クライアントのユーザー入力を待機中に活動状態でなくても、関係なく送信されます。 SVRCONN MQI エージェントも、同様にチャネルの状態に関係なく、クライアントへのハートビートを開始することができます。 SVRCONN MQI エージェントと CLNTCONN MQI エージェントは、互いに同時にハートビートを送信することがないように調整されています。 サーバーのハートビートは、ハートビート間隔より 5 秒長い時間待ってもチャネルを通してデータが転送されなかった場合に流れます。

IBM WebSphere MQ 7.0 の前にチャネルモードで動作しているサーバー接続およびクライアント接続チャネルの場合、サーバーMCAがクライアントアプリケーションに代わって発行した WAIT オプションを指定した MQGET コマンドを待機している場合にのみ、ハートビートが流れます。

詳しくは、 ハートビート間隔 (HBINT)を参照してください。

この属性を有効にするには、TCP/IP キープアライブをキュー・マネージャー、および TCP/IP の両方において使用可能にする必要があります。

z/OSでは、 ALTER QMGR TCPKEEP(YES) コマンドを発行して、キュー・マネージャーで TCP/IP キープアライブを有効にします。 ただし、キュー・マネージャーの TCPKEEP パラメーターが NO であると、この値は無視され、キープアライブ機能は使用されません。

分散プラットフォームでは、 TCP 節に KEEPALIVE=YES パラメータを指定すると、TCP/IPキープアライブが有効になります。 配布されたキューイング構成ファイルの TCP の節を、 qm.ini 、または IBM MQ Explorerで変更します。

TCP/IP 自体の中でもキープアライブをオンに切り替える必要があります。 キープアライブの構成について詳しくは、TCP/IP の資料を参照してください。 AIXでは、noコマンドを使用します。 HP-UXでは、 ndd コマンドを使用します。 Windows ではレジストリーを編集します。

z/OSでは、TCP/IP PROFILE データ・セットを更新し、 TCPCONFIG セクションの INTERVAL パラメーターを追加または変更します。

このパラメーターはすべてのプラットフォームで使用できますが、設定は z/OSにのみ実装されます。

分散プラットフォームでは、このパラメーターにアクセスおよび変更できますが、保管と転送のみです。パラメーターが機能的に実装されるわけではありません。 この機能は、 Solaris上のクラスター受信側チャネル定義に設定された値が、クラスター内にある (またはクラスターに結合する) z/OS キュー・マネージャーにフローする (実装される) クラスター環境で役立ちます。

分散プラットフォームでは、 KAINT パラメーターによって提供される機能が必要な場合は、ハートビート間隔 ( HBINT ) を使用します。 パラメーター ( HBINT を参照)。

( integer )

KeepAlive 秒単位で、1から99999の範囲で使用する間隔。

0

使用される値は、TCP プロファイル構成データ・セット内の INTERVAL ステートメントによって指定された値です。

AUTO

キープアライブ間隔は、次のように、折衝されたハートビート値に基づいて計算される。

• ネゴシエーションされた HBINT がゼロより大きい場合、キープアライブ間隔はその値に 60 秒を加算した値に設定されます。
• ネゴシエーションされた HBINT がゼロの場合、使用されるキープアライブ値は、TCP/IP PROFILE 構成データ・セットの INTERVAL ステートメントによって指定された値です。

KAINT に AUTO が設定されており、かつサーバー接続チャネルである場合、キープアライブ間隔の代わりに TCP INTERVAL の値が使用されます。

この場合、DISPLAY CHSTATUS で KAINT はゼロと表示されます。AUTO ではなく整数がコーディングされている場合はゼロ以外になります。

このパラメーターは、すべてのチャネル・タイプで有効です。 このパラメーターは、TRPTYPE が TCP または SPX 以外のチャネルの場合には無視されます。

LIKE(SYSTEM.DEF.SENDER)

これらのデフォルト・チャネル定義は、インストール時に、必須のデフォルト値に変更できます。

z/OS で、キューマネージャーは、指定した名前と または の処分を持つオブジェクトをページセットゼロで検索します。 QMGR COPY LIKE オブジェクトの処理は、定義するオブジェクトおよびチャネル・タイプにはコピーされません。

注:

1. QSGDISP(GROUP) オブジェクトは検索されません。
2. QSGDISP(COPY) が指定されている場合、 LIKE は無視されます。 ただし、定義されているグループ・オブジェクトは LIKE オブジェクトとして使用されます。

AMQP チャネル以外のチャネルの場合、LOCLADDR パラメーターは、トランスポート・タイプ (TRPTYPE) が TCP のチャネルにのみ有効です。 TRPTYPE が TCP でない場合、データは無視され、エラー・メッセージは発行されません。

LOCLADDR([ip-addr][(low-port[,high-port])][,[ip-addr][(low-port[,high-port])]])

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、RQSTR、CLNTCONN、CLUSSDR、または CLUSRCVR のチャネルにのみ有効です。

CLUSSDR チャネルでは、アウトバウンド・チャネルがバインドする IP アドレスおよびポートは、フィールドの組み合わせです。 つまり、LOCLADDR パラメーターに定義された IP アドレスと、クラスター・キャッシュから得られるポート範囲とを連結したものです。 キャッシュにポート範囲が存在しない場合、LOCLADDR パラメーターに定義されているポート範囲が使用されます。

このポート範囲は、 z/OS システムには適用されません。

このパラメーターは CONNAME の形式に類似していますが、混同しないでください。 LOCLADDR パラメーターはローカル通信の特性を指定しますが、CONNAME パラメーターはリモート・キュー・マネージャーに到達する方法を指定します。

ローカル・アドレス用の TCP/IP スタックがインストールまたは構成 されていない場合は、チャネルが開始されず、例外メッセージが生成されます。

例えば、'z/OSシステムでは、メッセージは"CSQO015E:Command issued but no reply received "となる このメッセージは、connect() 要求によってデフォルトの IP スタックでは認識されないインターフェース・アドレスが指定されたことを示しています。 connect() 要求を代替スタックに送信するには、代替スタックのインターフェースまたは DNS ホスト名として、チャネル定義に LOCLADDR パラメーターを指定します。 同じ仕様は、デフォルトのスタックを使用しないリスナーでも機能します。 LOCLADDR に対してコーディングする値を見つけるには、代替として使用する IP スタックで NETSTAT HOME コマンドを実行します。

AMQP チャネルの場合、LOCLADDR は、チャネルのローカル通信アドレスです。 このパラメーターは、特定の IP アドレスの使用をクライアントに強制する必要がある場合に使用します。 LOCLADDR は、チャネルが IPv4 または IPv6 アドレス (選択可能な場合) を使用するように強制したり、複数のネットワーク・アダプターがあるシステムで特定のネットワーク・アダプターを使用するように強制したりする場合にも役立ちます。

この回数を試みて接続に成功しない場合は、オペレーターあてにエラーがログに記録され、チャネルが停止します。 このようなときは、チャネルの再始動をコマンドで行う必要があります。 チャネル・イニシエーターによって自動的に再始動されることはありません。

LONGRTY 値は 0 から 9999999 の範囲でなければなりません。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、CLUSSDR、 または CLUSRCVR のチャネルにのみ有効です。

チャネル・イニシエーターで自動始動した場合とコマンドで明示的に始動させられた場合のどちらであっても、チャネルは最初の接続に失敗すると、再接続を試みます。 チャネルが正常に接続した後にその接続で障害が起きた場合にも、接続が再度試みられます。 失敗の原因によって、さらなる試行が成功する見込みがないと思われる場合は、再試行されません。

この時間はおおよその値です。0 は、できるだけ早く次の接続を試みることを意味します。

チャネルがアクティブになるまで待たなければならない場合には、再接続を試みる間隔が長くなることがあります。

LONGTMR 値は 0 から 9999999 の範囲でなければなりません。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、CLUSSDR、 または CLUSRCVR のチャネルにのみ有効です。

値は 0 から 999999999 の範囲でなければなりません。

値が 0 の場合、このチャネルでのクライアント・アクセスがすべて阻止されます。

実行中のインスタンスの数がこのパラメーターの値以上である場合、SVRCONN チャネルの新規インスタンスは開始できません。 MAXINST を現在実行中の SVRCONN チャネルのインスタンスの数より少ない値に変更しても、実行中のインスタンスの数には影響しません。

AMQP クライアントが AMQP チャネルへの接続を試みて接続クライアント数が MAXINST に達した場合、チャネルはクローズ・フレームで接続を閉じます。 クローズ・フレームには、メッセージ amqp:resource-limit-exceeded が含まれています。 既に接続されている ID にクライアントが接続した (つまり、クライアントがクライアント・テークオーバーを実行する) 場合、接続をテークオーバーすることをクライアントが許可されていれば、接続クライアント数が MAXINST に達したかどうかにかかわらず、テークオーバーは成功します。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SVRCONN または AMQP のチャネルにのみ有効です。

値は 0 から 999999999 の範囲でなければなりません。

値が 0 の場合、このチャネルでのクライアント・アクセスがすべて阻止されます。

MAXINSTC の値を、個別のクライアントから現在実行中の SVRCONN チャネルのインスタンス数より少ない数まで減らしても、実行中のインスタンスは影響を受けません。 そのクライアントからの新しい SVRCONN インスタンスは、クライアントが MAXINSTC の値よりも少ないインスタンス数で実行されるまで開始できません。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SVRCONN のチャネルにのみ有効です。

値ゼロは、キュー・マネージャーの最大メッセージ長を意味します。 ALTER QMGR MAXMSGL を参照してください。

AIX、 HP-UX、 IBM i、 Linux、Solaris、および Windowsでは、ゼロからキュー・マネージャーの最大メッセージ長までの範囲の値を指定します。

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

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

このパラメーターは予約済みです。指定する場合、設定できるのはブランク (最大長は 20 文字) です。

PROCESS

メッセージ・チャネル・エージェントは、独立のプロセスとして動作します。

THREAD

メッセージ・チャネル・エージェントは独立したスレッドとして実行されます。

スレッド・リスナーが多数の着信要求を処理しなければならないような状況では、リソースに過大な負担がかかることがあります。 その場合、複数のリスナー・プロセスを使用して、着信要求がリスナー上に指定されたポート番号を経由して特定のリスナーに送られるようにします。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、RQSTR、CLUSSDR、 または CLUSRCVR のチャネルにのみ有効です。 AIX HP-UX IBM i Linux、Solaris、Windows のみでサポートされています。

z/OS では、チャンネルタイプが のチャンネルのみがサポートされています。 CLUSRCVR CLUSRCVR 定義で指定された場合、MCATYPE がリモート・マシンによって使用されて対応する CLUSSDR 定義が判別されます。

このパラメーターは、 PUTAUT と対話します。 PUTAUT を参照してください。

MCAUSER が非ブランクの場合、メッセージ・チャネル・エージェントは、 IBM MQ リソースへのアクセスを許可するためにユーザー ID を使用します。 PUTAUT が DEF の場合、このアクセス許可には RCVR チャネルまたは RQSTR チャネルの宛先キューへのメッセージ書き込み許可も含まれます。

ブランクの場合、メッセージ・チャネル・エージェントはデフォルトのユーザー ID を使用します。

ストリングの最大長は、Windows では 64 文字、その他のプラットフォームでは 12 文字です。 Windows では、オプションで、user@domain の形式のドメイン・ネームを使用してユーザー ID を修飾できます。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、CLNTCONN、CLUSSDR のチャネルでは無効です。

このパラメーターは、トランスポート・タイプ (TRPTYPE) が LU62 のチャネルにのみ有効です。 TRPTYPE が LU62 でない場合、データは無視され、エラー・メッセージは発行されません。

このパラメーターを指定する場合は、CONNAME にサイド・オブジェクト名が含まれている場合を除き、SNA モード名に設定する必要があります。 CONNAME がサイド・オブジェクト名である場合は、ブランクに設定する必要があります。 実際の名前は、CPI-C 通信サイド・オブジェクト、または APPC サイド情報データ・セット から取られます。 LU 6.2 接続の構成パラメーター を参照してください。

このパラメーターは、チャネル・タイプ (CHLTYPE) が RCVR、または SVRCONN のチャネルでは無効です。

QMGR

キュー・マネージャー・パラメーターMONCHLの設定に従って、モニター・データを収集します。

OFF

このチャネルのモニター・データ収集はオフです。

LOW

キューマネージャの MONCHL パラメータの値が NONE でない場合、オンラインモニタリングデータが有効になります。 このチャネルのデータは低速で収集されます。

MEDIUM

キューマネージャの MONCHL パラメータの値が NONE でない場合、オンラインモニタリングデータが有効になります。 このチャネルについて中程度の速度で収集されたデータ。

HIGH

キューマネージャの MONCHL パラメータの値が NONE でない場合、オンラインモニタリングデータが有効になります。 このチャネルについて高い速度で収集されたデータ。

このパラメーターへの変更は、変更した後に開始されたチャネルにのみ適用されます。

クラスター・チャネルの場合、このパラメーターの値はリポジトリーに複製されないため、CLUSSDR チャネルの自動定義では使用されません。 自動定義の CLUSSDR チャネルの場合、このパラメーターの値はキュー・マネージャーの MONACLS 属性から取得されます。 次いでこの値は、チャネルの自動定義出口で指定変更されます。

このパラメーターは、チャネル・メッセージ再試行出口が呼び出された場合、その出口に引き渡されます。

このパラメーターは、チャネル・タイプ (CHLTYPE) が RCVR、RQSTR、または CLUSRCVR のチャネルにのみ有効です。

この名前の形式および最大長は MSGEXIT と同じですが、指定できるメッセージ再試行出口は 1 つのみです。

このパラメーターは、チャネル・タイプ (CHLTYPE) が RCVR、RQSTR、または CLUSRCVR のチャネルにのみ有効です。

このパラメーターは、メッセージ再試行出口名がブランクの場合にのみ MCA の処置を制御します。 出口名がブランクではないときは、MRRTY の値は、使用のため出口に引き渡されます。 メッセージの再送信を試行する回数は、このパラメーターによってではなく、出口によって制御されます。

値は 0 から 999999999 の範囲でなければなりません。 値 0 は、メッセージ再送信の試行が行われないことを意味します。

このパラメーターは、チャネル・タイプ (CHLTYPE) が RCVR、RQSTR、または CLUSRCVR のチャネルにのみ有効です。

このパラメーターは、メッセージ再試行出口名がブランクの場合にのみ MCA の処置を制御します。 出口名がブランクではないときは、MRTMR の値は、使用のため出口に引き渡されます。 メッセージの再送信を試行する回数は、このパラメーターによってではなく、出口によって制御されます。

値は 0 から 999999999 の範囲でなければなりません。 値 0 は、MRRTY の値が 0 より大きい場合に、できるだけ早くチャネルが送信を再試行することを意味します。

このパラメーターは、チャネル・タイプ (CHLTYPE) が RCVR、RQSTR、または CLUSRCVR のチャネルにのみ有効です。

これは、チャネル・メッセージ出口が呼び出された場合、その出口に引き渡されるデータです。

AIX、 HP-UX、 Linux、Solaris、および Windowsでは、複数のストリングをコンマで区切って指定することにより、複数の出口プログラムのデータを指定できます。 フィールドの全長は、最大 999 文字まででなければなりません。

IBM iでは、それぞれの長さが 32 文字のストリングを最大 10 個指定できます。 データの最初のストリングは、指定された最初のメッセージ出口に渡され、2 番目のストリングは 2 番目メッセージ出口に渡されます (それ以降、同様の処理が続きます)。

z/OSでは、それぞれの長さが 32 文字のストリングを 8 個まで指定できます。 データの最初のストリングは、指定された最初のメッセージ出口に渡され、2 番目のストリングは 2 番目メッセージ出口に渡されます (それ以降、同様の処理が続きます)。

その他のプラットフォームでは、各チャネルにメッセージ出口データのストリングを 1 つしか指定できません。

MSGEXIT を受け取ると、CLNTCONN チャネルおよび SVRCONN チャネルはそれを無視します。 CLNTCONN チャネルも SVRCONN チャネルもメッセージ出口を呼び出しません。

出口名の形式と最大長は、プラットフォームによって異なります。 表 5を参照してください。

MSGEXIT、MREXIT、SCYEXIT、SENDEXIT、 および RCVEXIT パラメーターがすべてブランクのままの場合、チャネル・ユーザー出口は呼び出されません。 これらのパラメーターのうちどれかが非ブランクの場合、チャネル出口プログラムが呼び出されます。 これらのパラメーターにはテキスト・ストリングを入力できます。 ストリングの最大長は 128 文字です。

表 5. メッセージ出口の形式および長さ

プラットフォーム	出口名の形式	最大長	コメント
AIX、 HP-UX、 Linux、および Solaris	libraryname(functionname)	128	複数の出口プログラムの名前を指定できます。 複数のストリングをコンマで区切って指定します。 ただし、指定する文字の合計数は 999 を超えてはなりません。
Windows	dllname(functionname)	128	複数の出口プログラムの名前を指定できます。 複数のストリングをコンマで区切って指定します。 ただし、指定する文字の合計数は 999 を超えてはなりません。 dllname は、接尾部 ( .DLL ) なしで指定されます。
IBM i	progname libname	20	複数のストリングをコンマで区切ることによって、最大 10 個の出口プログラムの名前を指定できます。 program name は最初の 10 文字を占め、 libname は次の 10 文字を占めます。 2 つのフィールドは両方とも、必要に応じて右側がブランクで埋め込まれます。
z/OS	loadModuleName	8	複数のストリングをコンマで区切ることによって、最大 8 個の出口プログラムの名前を指定できます。 CLNTCONN チャネルの出口名には 128 文字まで指定できます。ただし、合計最大長はコンマを含めて 999 文字です。

このパラメーターは、CLUSRCVR チャネルにのみ有効です。

FAST

非持続性メッセージの高速送達。チャネルが脱落すると、メッセージも脱落する場合があります。 メッセージは、MQGMO_SYNCPOINT_IF_PERSISTENT を使用して取得され、バッチ作業単位に組み込まれません。

NORMAL

非持続性メッセージの標準送達。

このパラメーターは、CHLTYPE が SDR、SVR、RCVR、RQSTR、CLUSSDR、 または CLUSRCVR のチャネルにのみ有効です。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、RQSTR、CLNTCONN、 または CLUSSDR のチャネルにのみ有効です。 z/OS では、チャンネルタイプ（ CHLTYPE ）が CLNTCONN であるチャンネルのみがサポートされています。

パラメーターの最大長は 12 文字ですが、使用されるのは最初の 10 文字のみです。

PROPCTL は、メッセージが別のキュー・マネージャーに送信されたときに、メッセージ・プロパティーがどうなるかを指定します。

このパラメーターは、SDR、 SVR、CLUSSDR、および CLUSRCVR の各チャネルに適用されます。

このパラメーターはオプションです。

DEF

デフォルトのユーザー ID が使用されます。

z/OSでは、DEF は、ネットワークから受信したユーザー ID と MCAUSER から得たユーザー ID の両方を意味する場合があります。

CTX

メッセージ記述子の UserIdentifier フィールドからのユーザー ID が使用されます。

z/OSでは、CTX は、ネットワークから受信したユーザー ID または MCAUSER から得たユーザー ID、あるいはその両方を意味する場合があります。

ONLYMCA

MCAUSER から得られたユーザー ID が使用されます。 ネットワークから受信したユーザー ID はどれも使用されません。 この値は、z/OS でのみサポートされています。

ALTMCA

メッセージ記述子の UserIdentifier フィールドのユーザー ID が使用されます。 ネットワークから受信したユーザー ID はどれも使用されません。 この値は、z/OS でのみサポートされています。

z/OSでは、検査されるユーザー ID、および検査されるユーザー ID の数は、MQADMIN RACF® クラス hlq.RESLEVEL ・プロファイルの設定によって異なります。 hlq.RESLEVEL に対してチャネル・イニシエーターのユーザー ID が持つアクセスのレベルに応じて、0、1、または 2 個のユーザー ID が検査されます。 検査されるユーザー ID の数については、 RESLEVEL とチャネル・イニシエーター接続を参照してください。 検査されるユーザー ID について詳しくは、 チャネル・イニシエーターで使用されるユーザー IDを参照してください。

分散プラットフォームでは、このパラメーターは、チャネル・タイプ (CHLTYPE) が RCVR、RQSTR、または CLUSRCVR のチャネルにのみ有効です。

z/OSでは、このパラメーターは、チャネル・タイプ (CHLTYPE) が RCVR、RQSTR、CLUSRCVR、または SVRCONN のチャネルにのみ有効です。 CTX および ALTMCA は SVRCONN チャネルには無効です。

CLNTCONN チャネルの場合、 QMNAME は、 IBM MQ MQI client アプリケーションが接続を要求できるキューマネージャの名前です。 QMNAME チャネルが定義されているキューマネージャの名前と同じとは限りません 。CCDTのキューマネージャグループを参照してください。

その他のタイプのチャネルでは、QMNAME パラメーターは無効です。

コマンドを適用するオブジェクトの属性指定 (どこで定義され、どのように動作するのか) について指定します。

DEFINE CHANNEL(channel-name) CHLTYPE(type) 
REPLACE QSGDISP(COPY)

このパラメーターはチャネル受信出口が呼び出されたとき、その出口に渡されます。

AIX、 HP-UX、 Linux、Solaris、および Windowsでは、複数のストリングをコンマで区切って指定することにより、複数の出口プログラムのデータを指定できます。 フィールドの全長は、最大 999 文字まででなければなりません。

IBM iでは、それぞれの長さが 32 文字のストリングを最大 10 個指定できます。 データの最初のストリングは、指定された最初の受信出口に渡され、次のストリングは、次の受信出口に渡され、以下この順に渡されます。

z/OSでは、それぞれの長さが 32 文字のストリングを 8 個まで指定できます。 データの最初のストリングは、指定された最初の受信出口に渡され、次のストリングは、次の受信出口に渡され、以下この順に渡されます。

その他のプラットフォームでは、各チャネルに受信出口データのストリングを 1 つしか指定できません。

AIX、 HP-UX、 Linux、Solaris、および Windowsでは、複数のストリングをコンマで区切って指定することにより、複数の出口プログラムの名前を指定できます。 ただし、指定する文字の合計数は 999 を超えてはなりません。

IBM iでは、複数のストリングをコンマで区切って指定することにより、最大 10 個の出口プログラムの名前を指定できます。

z/OSでは、複数のストリングをコンマで区切って指定することにより、最大 8 つの出口プログラムの名前を指定できます。

その他のプラットフォームでは、各チャネルに受信出口名を 1 つのみ指定できます。

名前の形式と最大長は、MSGEXIT と同じです。

このパラメーターはチャネル・セキュリティー出口が呼び出されたとき、その出口に渡されます。

この名前の形式および最大長は MSGEXIT と同じですが、指定できる名前は 1 つのみです。

このパラメーターはチャネル送信出口が呼び出されたとき、その出口に渡されます。

AIX、 HP-UX、 Linux、Solaris、および Windowsでは、複数のストリングをコンマで区切って指定することにより、複数の出口プログラムのデータを指定できます。 フィールドの全長は、最大 999 文字まででなければなりません。

IBM iでは、それぞれの長さが 32 文字のストリングを最大 10 個指定できます。 データの最初のストリングは、指定された最初の送信出口に渡され、次のストリングは、次の送信出口に渡され、以下この順に渡されます。

z/OSでは、それぞれの長さが 32 文字のストリングを 8 個まで指定できます。 データの最初のストリングは、指定された最初の送信出口に渡され、次のストリングは、次の送信出口に渡され、以下この順に渡されます。

その他のプラットフォームでは、各チャネルに送信出口データのストリングを 1 つしか指定できません。

AIX、 HP-UX、 Linux、Solaris、および Windowsでは、複数のストリングをコンマで区切って指定することにより、複数の出口プログラムの名前を指定できます。 ただし、指定する文字の合計数は 999 を超えてはなりません。

IBM iでは、複数のストリングをコンマで区切って指定することにより、最大 10 個の出口プログラムの名前を指定できます。

z/OSでは、複数のストリングをコンマで区切って指定することにより、最大 8 つの出口プログラムの名前を指定できます。

その他のプラットフォームでは、各チャネルに送信出口名を 1 つのみ指定できます。

名前の形式と最大長は、MSGEXIT と同じです。

この値は折衝不能であり、ローカルおよびリモートの両方のチャネル定義で一致しなければなりません。

値は 100 から 999999999 の範囲でなければなりません。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、RCVR、RQSTR、CLUSSDR、 または CLUSRCVR のチャネルにのみ有効です。

1

TCP/IP チャネル・インスタンスで会話を共有しないということを指定します。 MQGET 呼び出し内であるかどうかにかかわらず、クライアント・ハートビートが使用可能です。 先読みおよびクライアント非同期コンシュームも使用可能であり、チャネル静止の制御がさらに容易になります。

0

TCP/IP チャネル・インスタンスで会話を共有しないということを指定します。

値は 0 から 999999999 の範囲でなければなりません。

このパラメーターは、チャネル・タイプ (CHLTYPE) が CLNTCONN または SVRCONN のチャネルにのみ有効です。 CLNTCONN SHARECNV 値が SVRCONN SHARECNV 値に一致しない場合、2 つの値の小さいほうが使用されます。 このパラメーターは、トランスポート・タイプ (TRPTYPE) が TCP 以外のチャネルでは無視されます。

1 つのソケット上の会話はすべて、同一のスレッドによって受信されます。

SHARECNV の限度を大きくすると、キュー・マネージャー・スレッドの使用が削減されるという利点があります。 ソケットを共有する多数の会話がすべてビジー状態である場合、遅延が発生する可能性があります。 会話が受信スレッドを使用しようとして会話同士が互いに競合しています。 こうした状況では、より小さい SHARECNV 値を指定する方がより良い結果が得られます。

共有会話の数は、MAXINST または MAXINSTC の合計には加算されません。

値は 0 から 999999999 の範囲でなければなりません。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、CLUSSDR、 または CLUSRCVR のチャネルにのみ有効です。

チャネル・イニシエーターで自動始動した場合とコマンドで明示的に始動させられた場合のどちらであっても、チャネルは最初の接続に失敗すると、再接続を試みます。 チャネルが正常に接続した後にその接続で障害が起きた場合にも、接続が再度試みられます。 失敗の原因によって、さらなる試行が成功する見込みがないと思われる場合は、再試行されません。

この時間はおおよその値です。 IBM MQ 8.0以降、ゼロは、できるだけ早く接続が再試行されることを意味します。

チャネルがアクティブになるまで待たなければならない場合には、再接続を試みる間隔が長くなることがあります。

値は 0 から 999999999 の範囲でなければなりません。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、CLUSSDR、 または CLUSRCVR のチャネルにのみ有効です。

このパラメーターは、チャネル・タイプ (CHLTYPE) が RCVR、SVRCONN、CLUSRCVR、SVR、または RQSTR のチャネルにのみ有効です。

パラメーターは、SSLCIPH が指定されたチャネルにのみ使用されます。 SSLCIPH がブランクの場合、データは無視され、エラー・メッセージは発行されません。

REQUIRED

IBM MQ は、SSL クライアントからの証明書を必要とし、検証します。

OPTIONAL

対等 SSL クライアント・システムが、まだ証明書を送信する可能性があります。 送信する場合、この証明書の内容は、標準で検証されます。

チャネルの相手側にあるピア・キュー・マネージャーまたはクライアントで使用される証明書フィルターを指定します。 証明書の識別名を、このフィルターを使用して比較します。 識別名 は、SSL 証明書の ID です。 相手から受け取る証明書内の識別名が SSLPEER フィルターと一致しない場合、チャネルは開始しません。

SSLPEER はオプションです。 このオプションを指定しない場合、ピアの識別名はチャネル開始時に検査されません。 証明書からの識別名は、メモリーに保持されている SSLPEER 定義に引き続き書き込まれ、セキュリティー出口に渡されます。 SSLCIPH がブランクの場合、データは無視され、エラー・メッセージは発行されません。

このパラメーターは、すべてのチャネル・タイプで有効です。

SSLPEER('SERIALNUMBER=4C:D0:49:D5:02:5F:38,CN="H1_C_FR1",O=IBM,C=GB')

区切り文字として、コンマの代わりにセミコロンを使用できます。

SSLPEER ストリングにサポートされていない属性タイプを指定すると、属性を定義したときまたは実行時にエラーが出力されます。 どの時点でエラーが出力されるかは、稼働しているプラットフォームによって異なります。 エラーが出力された場合、SSLPEER ストリングが、フローされた証明書の識別名と一致しないことを示します。

('OU=Large Unit,OU=Medium Unit')
('OU=*,OU=Medium Unit,OU=Small Unit')
('OU=*,OU=Medium Unit')

('OU=Medium Unit,OU=Small Unit')
('OU=Large Unit,OU=Small Unit')
('OU=Medium Unit')
('OU=Small Unit, Medium Unit, Large Unit')

2 つの識別名がドメイン・コンポーネント (DC) 値以外のすべての点で同じである場合、OU の場合とほとんど同じ突き合わせルールが適用されます。 例外として、DC 値では左端のドメイン・コンポーネントが最下位のレベルで最も具体的であり、そのため比較の順序も異なります。

SSLPEER('CN=Test\*')
  

Windows、 IBM i、 UNIX、および Linux プラットフォームでは、パラメーターの最大長は 1024 バイトです。

z/OSでは、パラメーターの最大長は 256 バイトです。

チャネル認証レコード は、SSLPEER を使用するときの柔軟性を向上させ、すべてのプラットフォームで 1024 バイトをサポートします。

QMGR

キュー・マネージャーの STATCHL パラメーターの値は、チャネルによって継承されます。

OFF

このチャネルでの統計データ収集がオフになります。

LOW

キューマネージャの STATCHL パラメータの値が NONE でない場合、統計データの収集が有効になります。 このチャネルのデータは低速で収集されます。

MEDIUM

キューマネージャの STATCHL パラメータの値が NONE でない場合、統計データの収集が有効になります。このチャンネルでは、中程度の速度でデータが収集されます。

HIGH

キューマネージャの STATCHL パラメータの値が NONE でない場合、統計データの収集が有効になります。このチャンネルでは、高い割合でデータが収集されています。

このパラメーターへの変更は、変更した後に開始されたチャネルにのみ適用されます。

z/OSでは、このパラメーターは、選択した値に関係なく、単に統計データ収集をオンにします。 LOW、MEDIUM、または HIGH のどれを指定しても、結果に違いはありません。

クラスター・チャネルの場合、このパラメーターの値はリポジトリーに 複製されないため、CLUSSDR チャネルの自動定義では使用されません。 自動定義の CLUSSDR チャネルの場合、このパラメーターの値はキュー・マネージャーの STATACLS 属性から取得されます。 次いでこの値は、チャネルの自動定義出口で指定変更されます。

このパラメーターは、トランスポート・タイプ (TRPTYPE) が LU62 のチャネルにのみ有効です。

CONNAME にサイド・オブジェクト名が含まれていない限り、このパラメーターを SNA トランザクション・プログラム名に設定する必要があります。CONNAME にサイド・オブジェクト名が含まれている場合は、ブランクに設定する必要があります。 その代わりに、実際の名前は CPI-C コミュニケーション・サイド・オブジェクト、つまり APPC サイド情報データ・セットから取得されます。 LU 6.2 接続の構成パラメーター を参照してください。

Windows SNA Server、 、および z/OS上のサイド・オブジェクト では、TPNAME は大文字にラップされます。

このパラメーターは、チャネル・タイプ (CHLTYPE) が RCVR のチャネルでは無効です。

このパラメーターは、チャネル・タイプ (CHLTYPE) が AMQP のチャネルにのみ有効です。

AIX、 HP-UX、 Linux、 IBM i、 Solaris、 Windows、および z/OSでは、値を入力しない場合、 SYSTEM.DEF. channel-type 定義で指定された値が使用されるため、このパラメーターはオプションです。 チャネルの開始が相手側からであった場合、正しいトランスポート・タイプが指定されたかどうかの検査はありません。

z/OS において、 の定義が存在しない場合、デフォルトは です。 SYSTEM.DEF. channel-type LU62

NO

チャネルによって送信できないメッセージは、失敗したものとして扱われます。 チャネルは、NPMSPEED設定に従って、メッセージを破棄するか、チャネルが終了します。

YES

キュー・マネージャー属性 DEADQ に送達不能キューの名前が指定されている場合は、それが使用されます。そうでない場合は 、NO と同じ動作になります。 YES がデフォルト値です。

このパラメーターは、メッセージ・チャネル・エージェントが、リモート・メッセージ・チャネル・エージェントとの保護 LU 6.2 セッションの開始を試みるときに使用します。

分散プラットフォームでは、このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、RQSTR、CLNTCONN、または CLUSSDR のチャネルにのみ有効です。

z/OSでは、CLNTCONN チャネルでのみサポートされます。

パラメーターの最大長は 12 文字ですが、使用されるのは最初の 10 文字のみです。

メッセージが検索されるキューの名前。 IBM MQ オブジェクトの命名規則を参照してください。

このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR または SVR のチャネルにのみ有効です。 これらのチャネル・タイプでは、必須のパラメーターです。