[UNIX、Linux、Windows、IBM i]

クライアント構成ファイルの CHANNELS スタンザ

CHANNELS スタンザを使用して、クライアント・チャネルに関する情報を指定します。

注: このスタンザの各属性の説明は、どの IBM® MQ クライアントがその属性を読み取ることができるかを示しています。 すべての IBM MQ MQI client 構成ファイル・スタンザの要約表については、 Which IBM MQ attributes can be read by each clientを参照してください。
次の属性を CHANNELS スタンザに含めることができます。
CCSID = 数値
使用するコード化文字セット番号。

属性は、C、非管理対象.NET、管理対象.NET、および管理対象XMS .NETクライアントによって読み取ることができます。

CCSID 番号は、 MQCCSID 環境変数と同等です。

ChannelDefinitionDirectory = パス
クライアント・チャネル定義テーブルを含むファイルのディレクトリー・パス。

属性は、C、非管理対象.NET、管理対象.NET、および管理対象XMS .NETクライアントによって読み取ることができます。

[Windows] Windows システムでは、デフォルトは IBM MQ データとログファイルのディレクトリで、通常は C:\ProgramData\IBM\MQ です。

[AIX][Linux] AIX® and Linux®システムでは、デフォルトは/var/mqmである。

ChannelDefinitionDirectoryには ChannelDefinitionFileと組み合わせてURL を含めることができます （CCDT URLを参照）。

ChannelDefinitionDirectory パスは MQCHLLIB 環境変数と同じです。

ChannelDefinitionFile = ファイル名|AMQCLCHL.TAB
クライアント・チャネル定義テーブルを含むファイルの名前。

属性は、C、非管理対象.NET、管理対象.NET、および管理対象XMS .NETクライアントによって読み取ることができます。

クライアント・チャネル定義テーブルは、 MQCHLTAB 環境変数と同等です。

ChannelDefinitionDirectoryとChannelDefinitionFileを合わせた属性の最大長は、オペレーティングシステムの最大ファイルパス長です。

ReconDelay=(delay[、rand])(delay[、rand])...
ReconDelay 属性は、自動的に再接続できるクライアント・プログラムに対して再接続遅延を構成するための管理オプションを提供します。

属性は、C、非管理対象.NET、IBM MQ classes for JMS、管理対象.NET、および管理対象XMS .NET クライアントによって読み取ることができます。

構成の例は以下のとおりです。
ReconDelay=(1000,200)(2000,200)(4000,1000)
示されている例では、初回の遅延を 1 秒に 200 ミリ秒までのランダム間隔を加算した値として定義します。 その次の遅延は 2 秒に 200 ミリ秒までのランダム間隔を加算した値です。 その後の遅延はすべて、4 秒に 1000 ミリ秒までのランダム間隔を加算した値です。
DefRecon = いいえ | はい | QMGR | 無効
DefRecon 属性は、 クライアント・プログラムによる自動再接続を有効にするか、 自動的に再接続するように作成されたクライアント・プログラムの自動再接続を無効にするための 管理オプションを提供します。 プログラムが再接続との互換性がない MQPMO_LOGICAL_ORDER のようなオプションを使用する場合は、後者の設定を選択できます。

属性は、C、非管理対象.NET、IBM MQ classes for JMS、管理対象.NET、および管理対象XMS .NET クライアントによって読み取ることができます。

IBM MQ classes for Javaでは、自動クライアント再接続はサポートされていません。

自動クライアント再接続は通常、以下の 2 つの値に依存します。
  • アプリケーション MQCONNX (または JMS 接続ファクトリー) で設定された再接続オプション
  • 使用中のクライアント接続定義 (例えば、CCDT ファイルを使用して提供される MQCD 構造体) で提供されるデフォルトの再接続オプション。
mqclient.ini ファイル属性は、 DefReconnect 属性を設定するチャネル定義が使用されていない場合に のみ 適用されます。この場合、この属性は指定された場合と同様に動作します。 チャネルの DefReconnect 属性 (および該当する場合はこの属性):
  • いずれかが DISABLED に設定されている場合は、アプリケーション・コードをオーバーライドします。
  • オプションが MQCONNX で指定されている場合は、他のすべての場合にアプリケーション・コードによってオーバーライドされます。
アプリケーションとチャネル定義の提供値の考えられるすべての組み合わせを示す表については、 DEFRECON の説明を参照してください。
注:
  • MQCD が使用されているが、 MQCD_VERSION_10より前の日付の場合、 DefReconnnect パラメーターは構造体の一部ではありません。 この場合、欠落しているパラメーターの値には、 mqclient.ini file DefReconnnect 値 (指定されている場合) が取り込まれます。 これは、例えば、古いバージョンの IBM MQ で生成されたバイナリー形式の CCDT がクライアント・アプリケーションによって引き続き使用されている場合に発生する可能性があります。
  • IBM MQクライアントコードによって解釈される場合、JSONフォーマットCCDTの設定を参照したJSON CCDTは、常に最新のバージョンでMQCD構造を生成するため、明示的に異なる値が提示されない限り、常にこの属性のデフォルト値(NO)を提供する。
MQReconnectTimeout

クライアント内の自動クライアント再接続機能が接続の再確立を試行する最大時間 (秒数)。 デフォルト値は 1800 秒 (30 分) です。

この属性は、C および非管理対象 .NET クライアント、および管理対象 .NET クライアントによって読み取ることができます。

IBM MQ classes for JMS クライアントは、接続ファクトリー・プロパティー CLIENTRECONNECTTIMEOUTを使用して、再接続するタイムアウトを指定できます。 このプロパティーのデフォルト値は 1800 秒 (30 分) です。

IBM MQ classes for XMS .NET クライアントは、以下のプロパティーを使用して、再接続するタイムアウトを指定できます。
  • 接続ファクトリーのプロパティー CLIENTRECONNECTTIMEOUT。 このプロパティーのデフォルト値は 1800 秒 (30 分) です。 このプロパティーは、管理対象モードでのみ有効です。
  • プロパティー XMSC.WMQ_CLIENT_RECONNECT_TIMEOUT。 このプロパティーのデフォルト値は 1800 秒 (30 分) です。 このプロパティーは、管理対象モードでのみ有効です。
ServerConnectionParms
ServerConnectionParms はMQSERVER 環境変数と同等で、IBM MQサーバーの場所と使用する通信方法を指定する。

属性は、C、非管理対象.NET、管理対象.NET、および管理対象XMS .NETクライアントによって読み取ることができます。

ServerConnectionParms 属性で定義するのは単純なチャネルのみです。この属性を使用して、TLS チャネルやチャネル出口があるチャネルを定義することはできません。 これは ChannelName/TransportType/ConnectionName という形式のストリングで、ConnectionName は完全修飾ネットワーク名であることが必要です。 ChannelName に、スラッシュ文字 (/) を使用することはできません。スラッシュ文字はチャネル名、トランスポート・タイプ、および接続名を区切るために使用されるからです。

クライアント・チャネルを定義するために ServerConnectionParms が使用されている場合は、最大メッセージ長として 100 MB が使用されます。 そのため、チャネルの最大メッセージ・サイズは、実際にはサーバーの SVRCONN チャネルに指定した値となります。
クライアント・チャネル接続は 1 つしか作成できないことに注意してください。 例えば、次のような 2 つの項目があるとします。
ServerConnectionParms=R1.SVRCONN/TCP/localhost(1963)
ServerConnectionParms=R2.SVRCONN/TCP/localhost(1863)
この場合、2 番目だけが使用されます。

ConnectionName を、記述済みトランスポート・タイプ名のコンマ区切りのリストとして指定します。 通常、必要な名前は 1 つのみです。 複数の hostnamesを指定して、同じプロパティーで複数の接続を構成することができます。 接続は、正常に確立されるまで、接続リストに指定された順序で試行されます。 正常に接続が行われなかった場合は、クライアントが再び処理を開始します。 接続リストは、キュー・マネージャー・グループの代替として、再接続可能なクライアントの接続を構成するために使用されます。

Put1DefaultAlwaysSync = NO (デフォルト) | YES
オプション MQPMO_RESPONSE_AS_Q_DEF を指定して MQPUT1 関数呼び出しの動作を制御します。

この属性は、C、管理されていない.NET、IBM MQ classes for Java、IBM MQ classes for JMS、管理対象.NET、および管理対象XMS .NETクライアントから読み取ることができる。

NO
MQPUT1 が MQPMO_SYNCPOINT で設定される場合、MQPMO_ASYNC_RESPONSE として動作します。 同様に、 MQPUT1 が MQPMO_NO_SYNCPOINT で設定される場合、MQPMO_SYNC_RESPONSE として動作します。 これがデフォルト値です。
YES
MQPUT1 は、MQPMO_SYNCPOINT または MQPMO_NO_SYNCPOINT が設定されているかどうかに関係なく MQPMO_SYNC_RESPONSE が設定されている場合のように動作します。
PasswordProtection = Compatible (デフォルト) |always|オプション

IBM MQ 8.0以降、 IBM MQ client アプリケーションがキュー・マネージャーに接続するときに指定する認証資格情報は、接続で TLS 暗号化を使用しない場合、 IBM MQ MQCSP パスワード保護機能を使用して保護することができます。

この属性は、C、管理されていない.NET、IBM MQ classes for Java、IBM MQ classes for JMS、管理対象.NET、および管理対象XMS .NETクライアントから読み取ることができる。

MQCSP パスワード保護は TLS 暗号化より設定が簡単なので、テストや開発目的に役立ちます。ただし、それほど安全ではありません。

MQCSP 構造で資格情報を保護する方法、およびこの属性に設定できる値について詳しくは、 MQCSP パスワード保護を参照してください。