![[IBM i]](ngibmi.gif)
MQ チャネルのコピー (CPYMQMCHL)
- 実行可能な場所
- すべての環境 (*ALL)
- スレッド・セーフ
- はい
MQ チャネルのコピー (CPYMQMCHL) コマンドは、同じタイプの新規 MQ チャネル定義を作成します。コマンドに指定されていない属性については、既存のチャネル定義と同じ属性値を使用します。
パラメーター
| キーワード | 説明 | 選択 | 注 |
|---|---|---|---|
| FROMCHL | コピー元チャネル | 文字値 | 必須、キー、定位置 1 |
| TOCHL | コピー先チャネル | 文字値 | 必須、キー、定位置 2 |
| MQMNAME | メッセージ・キュー・マネージャー名 | 文字値、*DFT | オプション、キー、定位置 3 |
| CHLTYPE | チャネル・タイプ | *RCVR、*SDR、*SVR、*RQSTR、*SVRCN、*CLUSSDR、*CLUSRCVR、*CLTCN | オプション、キー、定位置 4 |
| REPLACE | 置換 | *NO、*YES | オプショナル, 定位置 5 |
| TRPTYPE | トランスポート・タイプ | *LU62、*TCP、*SAME | オプショナル, 定位置 6 |
| text | テキスト '記述' | 文字値、*BLANK、*SAME | オプショナル, 定位置 7 |
| TGTMQMNAME | ターゲット・キュー・マネージャー | 文字値、*NONE、*SAME | オプショナル, 定位置 8 |
| CONNAME | 接続名 | 文字値、*NONE、*SAME | オプショナル, 定位置 9 |
| TPNAME | トランザクション・プログラム名 | 文字値、*BLANK、*SAME | オプショナル, 定位置 10 |
| MODENAME | モード名 | 文字値、*BLANK、*SAME | オプショナル, 定位置 11 |
| TMQNAME | 伝送キュー | 文字値、*SAME | オプション、定位置 12 |
| MCANAME | MSGチャネル・エージェント | 単一値: *SAME、*NONE その他の値: 修飾オブジェクト名 | オプション、定位置 13 |
| 修飾子 1: メッセージ・チャネル・エージェント | 名前 | ||
| 修飾子 2: ライブラリー | 名前、 *CURLIB | ||
| MCAUSRID | MSGチャネルAGENTユーザーID | 文字値、*NONE、*PUBLIC、*SAME | オプション、定位置 14 |
| MCATYPE | メッセージ・チャネル・エージェントのタイプ | *PROCESS、*THREAD、*SAME | オプション、定位置 15 |
| BATCHINT | バッチ間隔 | 0-999999999、*SAME | オプション、定位置 16 |
| BATCHSIZE | バッチ・サイズ | 1-9999、*SAME | オプション、定位置 17 |
| DSCITV | 切断間隔 | 0-999999、*SAME | オプション、定位置 18 |
| SHORTTMR | 短期再試行間隔 | 0-999999999、*SAME | オプション、定位置 19 |
| SHORTRTY | 短期再試行カウント | 0-999999999、*SAME | オプション、定位置 20 |
| LONGTMR | 長期再試行間隔 | 0-999999999、*SAME | オプション、定位置 21 |
| LONGRTY | 長期再試行カウント | 0-999999999、*SAME | オプション、定位置 22 |
| SCYEXIT | セキュリティー出口 | 単一値: *SAME、*NONE その他の値: 修飾オブジェクト名 | オプション、定位置 23 |
| 修飾子 1: セキュリティー出口 | 名前 | ||
| 修飾子 2: ライブラリー | 名前、 *CURLIB | ||
| CSCYEXIT | セキュリティー出口 | 文字値、*SAME、*NONE | オプション、定位置 24 |
| SCYUSRDATA | セキュリティー出口ユーザー・データ | 文字値、*SAME、*NONE | オプション、定位置 25 |
| SNDEXIT | 送信出口 | 単一値: *SAME、*NONE その他の値 (10 回までの繰り返し): 修飾オブジェクト名 | オプション、定位置 26 |
| 修飾子 1: 送信出口 | 名前 | ||
| 修飾子 2: ライブラリー | 名前、 *CURLIB | ||
| CSNDEXIT | 送信出口 | 単一値: *SAME、*NONE その他の値 (最大 10 回の繰り返し): 文字値 | オプション、定位置 27 |
| SNDUSRDATA | 送信出口ユーザー・データ | 値 (繰り返しは 10 回まで): 文字値、 *SAME、*NONE | オプション、定位置 28 |
| RCVEXIT | 受信出口 | 単一値: *SAME、*NONE その他の値 (10 回までの繰り返し): 修飾オブジェクト名 | オプション、定位置 29 |
| 修飾子 1: 受信出口 | 名前 | ||
| 修飾子 2: ライブラリー | 名前、 *CURLIB | ||
| CRCVEXIT | 受信出口 | 単一値: *SAME、*NONE その他の値 (最大 10 回の繰り返し): 文字値 | オプション、定位置 30 |
| RCVUSRDATA | 受信出口ユーザー・データ | 値 (繰り返しは 10 回まで): 文字値、 *SAME、*NONE | オプション、定位置 31 |
| MSGEXIT | メッセージ出口 | 単一値: *SAME、*NONE その他の値 (10 回までの繰り返し): 修飾オブジェクト名 | オプション、定位置 32 |
| 修飾子 1: メッセージ出口 | 名前 | ||
| 修飾子 2: ライブラリー | 名前、 *CURLIB | ||
| MSGUSRDATA | メッセージ出口ユーザー・データ | 値 (繰り返しは 10 回まで): 文字値、 *SAME、*NONE | オプション、定位置 33 |
| MSGRTYEXIT | MSG再試行出口 | 単一値: *SAME、*NONE その他の値: 修飾オブジェクト名 | オプション、定位置 34 |
| 修飾子 1: メッセージ再試行出口 | 名前 | ||
| 修飾子 2: ライブラリー | 名前、 *CURLIB | ||
| MSGRTYDATA | MSG再試行出口データ | 文字値、*SAME、*NONE | オプション、定位置 35 |
| MSGRTYNBR | MSG再試行回数 | 0-999999999、*SAME | オプション、定位置 36 |
| MSGRTYITV | メッセージ再試行間隔 | 0-999999999、*SAME | オプション、定位置 37 |
| CVTMSG | メッセージの変換 | *YES、*NO、*SAME | オプション、定位置 38 |
| PUTAUT | 書き込む権限 | *DFT、*CTX、*SAME | オプション、定位置 39 |
| SEQNUMWRAP | シーケンス番号折り返し | 100-999999999、*SAME | オプション、定位置 40 |
| MAXMSGLEN (MAXMSGLEN) | 最大メッセージ長 | 0-104857600、*SAME | オプション、定位置 41 |
| HRTBTINTVL | ハートビート間隔 | 0-999999999、*SAME | オプション、定位置 42 |
| NPMSPEED | 非持続メッセージ速度 | *FAST、*NORMAL、*SAME | オプション、定位置 43 |
| CLUSTER | クラスター名 | 文字値、*NONE、*SAME | オプション、定位置 44 |
| CLUSNL | クラスター名リスト | 文字値、*NONE、*SAME | オプション、定位置 45 |
| NETPRTY | ネットワーク接続優先順位 | 0-9、*SAME | オプション、定位置 46 |
| SSLCIPH | TLS CipherSpec | Character value、'*TLS_RSA_WITH_NULL_MD5'、'*TLS_RSA_WITH_NULL_SHA'、'*TLS_RSA_EXPORT_WITH_RC4_40_MD5'、'*TLS_RSA_WITH_RC4_128_MD5'、'*TLS_RSA_WITH_RC4_128_SHA'、'*TLS_RSA_EXPORT_WITH_RC2_40_MD5'、'*TLS_RSA_WITH_DES_CBC_SHA'、'*TLS_RSA_WITH_3DES_EDE_CBC_SHA'、'*TLS_RSA_WITH_AES_128_CBC_SHA'、'*TLS_RSA_WITH_AES_256_CBC_SHA'、*NONE、*SAME | オプション、定位置 47 CipherSpec TLS_RSA_WITH_3DES_EDE_CBC_SHA は推奨されません。 |
| SSLCAUTH | TLS クライアント認証 | *REQUIRED、*OPTIONAL、 *SAME | オプション、定位置 48 |
| SSLPEER | TLS ピア名 | 文字値、*NONE、*SAME | オプション、定位置 49 |
| LOCLADDR | ローカル通信アドレス | 文字値、*NONE、*SAME | オプション、定位置 50 |
| BATCHHB | バッチ・ハートビート間隔 | 0-999999999、*SAME | オプション、定位置 51 |
| USERID | タスク・ユーザー ID | 文字値、*NONE、*SAME | オプション、定位置 52 |
| PASSWORD | パスワード | 文字値、*NONE、*SAME | オプション、定位置 53 |
| KAINT | キープアライブ・インターバル | 0-99999、*SAME、*AUTO | オプション、定位置 54 |
| COMPHDR | ヘッダー圧縮 | 値 (繰り返しが 2 回まで): *NONE、*SYSTEM、 *SAME | オプション、定位置 55 |
| COMPMSG | メッセージ圧縮 | 単一値: *ANY その他の値 (最大 4 個指定可能): *NONE、*RLE、*ZLIBHIGH、*ZLIBFAST、 *SAME | オプション、定位置 56 |
| MONCHL | チャネル・モニター | *QMGR、*OFF、*LOW、*MEDIUM、*HIGH、*SAME | オプション、定位置 57 |
| STATCHL | チャネル統計 | *QMGR、*OFF、*LOW、*MEDIUM、*HIGH、*SAME | オプション、定位置 58 |
| CLWLRANK | CLUSTER WORKLOADランク | 0-9、*SAME | オプション、定位置 59 |
| CLWLPRTY | CLUSTER WORKLOAD優先順位 | 0-9、*SAME | オプション、定位置 60 |
| CLWLWGHT | CLUSTER CHANNELウェイト | 1-99、*SAME | オプション、定位置 61 |
| SHARECNV | 共用会話 | 0-999999999、*SAME | オプション、定位置 62 |
| PROPCTL | プロパティー制御 | *COMPAT、*NONE、*ALL、*SAME | オプション、定位置 63 |
| MAXINST | 最大インスタンス数 | 0-999999999、*SAME | オプション、定位置 64 |
| MAXINSTC | クライアントの最大インスタンス | 0-999999999、*SAME | オプション、定位置 65 |
| CLNTWGHT | CLIENT CHANNELウェイト | 0-99、*SAME | オプション、定位置 66 |
| アフィニティー | 接続アフィニティー | *PREFERRED、*NONE、*SAME | オプション、定位置 67 |
| BATCHLIM | バッチ・データ制限 | 0-999999、*SAME | オプション、定位置 68 |
| DFTRECON (DFTRECON) | デフォルトのクライアント再接続 | *NO、*YES、*QMGR、*DISABLED、*SYSDFTCHL | オプション、定位置 69 |
コピー元チャネル (FROMCHL)
このコマンドに指定されていない属性の値が入っている既存のチャネル定義の名前を指定します。
指定できる値は以下のとおりです。
- from-channel-name
- ソース MQ チャネルの名前を指定します。
コピー先チャネル (TOCHL)
新規のチャネル定義の名前を指定します。 この名前には、最大 20 文字を含めることができます。 チャネル名は固有でなければなりません。 この名前のチャネル定義が既に存在する場合には、REPLACE(*YES) を指定する必要があります。
指定できる値は以下のとおりです。
- to-channel-name
- 作成する MQ チャネルの名前を指定します。
メッセージ・キュー・マネージャー名 (MQMNAME)
メッセージ・キュー・マネージャーの名前を指定します。
指定できる値は以下のとおりです。
- *DFT
- デフォルト・キュー・マネージャーが使用されます。 システム上にデフォルト・キュー・マネージャーが定義されていない場合には、このコマンドは失敗します。
- message-queue-manager-name
- メッセージ・キュー・マネージャーの名前です。
チャネル・タイプ (CHLTYPE)
コピーされるチャネルのタイプを指定します。
指定できる値は以下のとおりです。
- *SDR
- 送信側チャネル
- *SVR
- サーバー・チャネル
- *RCVR
- 受信側チャネル
- *RQSTR
- 要求側チャネル
- *SVRCN
- サーバー接続チャネル
- *CLUSSDR
- クラスター送信側チャネル
- *CLUSRCVR
- クラスター受信側チャネル
- *CLTCN
- クライアント接続チャネル
置換 (REPLACE)
新規のチャネル定義が、同じ名前の既存のチャネル定義を置き換えるかどうかを指定します。
指定できる値は以下のとおりです。
- *NO
- 既存のチャネル定義を置き換えません。 指定されたチャネル定義が既に存在する場合、コマンドは失敗します。
- *YES
- 既存のチャネル定義を置き換えます。 同じ名前の定義がない場合は、新規の定義が作成されます。
トランスポート・タイプ (TRPTYPE)
伝送プロトコルを指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *LU62
- SNA LU 6.2。
- *TCP
- 伝送制御プロトコル/インターネット・プロトコル (TCP/IP)。
テキスト '記述' (TEXT)
チャネル定義を簡単に説明するテキストを指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *BLANK
- テキストはブランク・ストリングに設定されます。
- description
- 64文字以下の文字を、アポストロフィで囲んで指定します。
注 : フィールド長は 64 バイトであり、システムが 2 バイト文字セット (DBCS) を使用している場合、最大文字数が少なくなります。
ターゲット・キュー・マネージャー (TGTMQMNAME)
ターゲット・キュー・マネージャーの名前を指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- クライアント接続チャネル (CHLTYPE) *CLTCN のターゲット・キュー・マネージャーの名前は指定されません。
- message-queue-manager-name
- クライアント接続チャネル (CHLTYPE) *CLTCN のターゲット・メッセージ・キュー・マネージャーの名前。
その他のチャネル・タイプの場合には、このパラメーターを指定してはなりません。
接続名 (CONNAME)
接続するマシンの名前を指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- 接続名はブランクです。
- 接続名
- 伝送プロトコルで必要とされる接続名を次のように指定します。
- *LU62 では、CSI オブジェクトの名前を指定します。
- *TCP では、リモート・マシン (またはクラスター受信側チャネルのローカル・マシン) のホスト名またはネットワーク・アドレスのどちらかを指定します。 この後に、括弧で囲んだポート番号をオプションで指定できます。
![[UNIX、Linux、Windows、IBM i]](../common/../com.ibm.mq.ref.adm.doc/ngmulti.gif)
Multiplatformsでは、クラスター受信側チャネルの TCP/IP 接続名パラメーターはオプションです。 接続名をブランクのままにすると、 IBM® MQ はデフォルト・ポートを想定し、システムの現行 IP アドレスを使用して接続名を自動的に生成します。 デフォルト・ポート番号をオーバーライドしても、システムの現行 IP アドレスを引き続き使用できます。 各接続名について、 IP 名をブランクにして、次のように括弧で囲んだポート番号を指定してください。
生成される CONNAME は常にドット 10 進 (IPv4) 形式または 16 進 (IPv6) 形式であり、英数字の DNS ホスト名の形式ではありません。(1415)ポートを指定しない場合には、デフォルト・ポート 1414 が想定されます。
クラスター受信側チャネルの場合、接続名はローカル・キュー・マネージャーに関連し、その他のチャネルの場合、接続名はターゲット・キュー・マネージャーに関連します。
このパラメーターは、チャネル・タイプ (CHLTYPE) が *SDR、*RQSTR、*CLTCN、および *CLUSSDR のチャネルの場合に必須です。 *SVR および *CLUSRCVR チャネルの場合はオプションであり、*RCVR または *SVRCN チャネルの場合は無効になります。
トランザクション・プログラム名 (TPNAME)
このパラメーターは、TRPTYPE が LU 6.2 として定義されているチャネルの場合のみ有効です。
このパラメーターは、CONNAME にサイド・オブジェクト名が指定されている場合を除いて、SNA トランザクション・プログラム名に設定しなければなりません。CONNAME にサイド・オブジェクト名が指定されている場合は、ブランクに設定する必要があります。 代わりに、CPI-C 通信サイド・オブジェクトから名前が取り出されます。
CHLTYPE が *RCVR として定義されているチャネルの場合には、このパラメーターは無効です。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- *NONE 値
- トランザクション・プログラム名は指定されません。
- *BLANK
- トランザクション・プログラム名は CPI-C 通信サイド・オブジェクトから取り出されます。 このサイド・オブジェクト名は、CONNAME パラメーターに指定しなければなりません。
- transaction-program-name
- SNA トランザクション・プログラム名を指定します。
モード名 (MODENAME)
このパラメーターは、TRPTYPE が LU 6.2 として定義されているチャネルの場合のみ有効です。 TRPTYPE が LU 6.2 として定義されていない場合には、データは無視され、エラー・メッセージは出されません。
指定する場合、CONNAME にサイド・オブジェクト名が指定されている場合を除いて、値を SNA モード名に設定しなければなりません。CONNAME にサイド・オブジェクト名が指定されている場合は、値をブランクに設定する必要があります。 これで、名前は、CPI-C 通信サイド・オブジェクトから取り出されます。
CHLTYPE が *RCVR または *SVRCONN として定義されているチャネルの場合には、このパラメーターは無効です。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- *NONE 値
- モード名は指定されません。
- *BLANK
- 名前は CPI-C 通信サイド・オブジェクトから取り出されます。 これは、CONNAME パラメーターに指定されなければなりません。
- SNA-mode-name
- SNA モード名を指定します。
伝送キュー (TMQNAME)
伝送キューの名前を指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- 伝送キュー名
- 伝送キューの名前を指定します。 CHLTYPE が *SDR または *SVR として定義されている場合、伝送キュー名は必須です。
その他のチャネル・タイプの場合には、このパラメーターを指定してはなりません。
メッセージ・チャネル・エージェント (MCANAME)
このパラメーターは予約済みです。使用しないでください。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- MCA プログラム名はブランクです。
CHLTYPE が *RCVR、*SVRCN、または *CLTCN として定義されている場合には、このパラメーターを指定することはできません。
メッセージ・チャネル・エージェント・ユーザー ID (MCAUSRID)
メッセージ・チャネル・エージェントは、ここで指定するメッセージ・チャネル・エージェント・ユーザー ID を使用して、MQ リソースにアクセスする許可を与えます。受信側チャネルまたは要求側チャネルの宛先キューにメッセージを書き込む許可も含みます (PUTAUT が *DFT の場合)。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- メッセージ・チャネル・エージェントはそのデフォルト・ユーザー ID を使用します。
- *PUBLIC
- 共通権限を使用します。
- mca-user-identifier
- 使用されるユーザー ID を指定します。
チャネル・タイプ (CHLTYPE) が *CLTCN の場合、このパラメーターを指定することはできません。
メッセージ・チャネル・エージェント・タイプ (MCATYPE)
メッセージ・チャネル・エージェント・プログラムをスレッドとして実行するか、プロセスとして実行するかを指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *PROCESS (処理)
- メッセージ・チャネル・エージェントは、独立のプロセスとして動作します。
- *THREAD (* スレッド)
- メッセージ・チャネル・エージェントは独立したスレッドとして実行されます。
このパラメーターは、CHLTYPE が *SDR、*SVR、*RQSTR、*CLUSSDR、または *CLUSRCVR として定義されているチャネルにのみ指定できます。
バッチ間隔 (BATCHINT)
チャネルがバッチ・オープンを保持する最小時間 (ミリ秒) です。
次のどれでも最初に発生したらバッチは終了します: BATCHSZ メッセージが送信される、BATCHLIM バイトに到達する、または伝送キューが空で BATCHINT を超える。
デフォルト値は 0 であり、これは、伝送キューが空になった (または BATCHSZ 限度に達した) 時点でバッチが終了することを意味します。
値は 0 から 999999999 の範囲でなければなりません。
このパラメーターは、CHLTYPE が *SDR、*SVR、*CLUSSDR、または *CLUSRCVR として定義されているチャネルの場合に有効です。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- batch-interval
- 0 から 999999999 の範囲の値を指定します。
バッチ・サイズ (BATCHSIZE)
チェックポイントを通過する前にチャネルを通じて送信できるメッセージの最大数を指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- バッチ・サイズ
- 1 から 9999 の範囲の値を指定します。
*CLTCN または *SVRCN のチャネル・タイプ (CHLTYPE) では、 このパラメーターを指定することはできません。
切断間隔 (DSCITV)
切断間隔を指定します。これは、チャネルをクローズする前に、そのチャネルが伝送キューへのメッセージの書き込みを待機する最大秒数を定義します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- disconnect-interval
- 0 から 999999 の範囲の値を指定します。
*RCVR、*RQSTR、または *CLTCN のチャネル・タイプ (CHLTYPE) では、 このパラメーターを指定することはできません。
短期再試行間隔 (SHORTTMR)
チャネル・イニシエーターによって自動的に開始される送信側チャネル、サーバー・チャネル、またはクラスター・チャネル (*SDR、*SVR、*CLUSSDR、または *CLUSRCVR) の短期再試行待機間隔を指定します。 これは、リモート・マシンへの接続の確立を次に試みるまでの間隔を定義します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- short-retry-interval
- 0から999999999の範囲の値を指定します。
短期再試行カウント (SHORTRTY)
チャネル・イニシエーターによって自動的に開始される送信側チャネル、サーバー・チャネル、またはクラスター・チャネル (*SDR、*SVR、*CLUSSDR、または *CLUSRCVR) の短期再試行カウントを指定します。 LONGRTY および LONGTMR (通常は長い方) が使用される前に、SHORTTMR で指定された間隔で、リモート・マシンへの接続の確立が試みられる最大回数を定義します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- short-retry-count
- 0から999999999の範囲の値を指定します。 値 0 は、再試行が許可されないことを意味します。
長期再試行間隔 (LONGTMR)
チャネル・イニシエーターによって自動的に開始される送信側チャネル、サーバー・チャネル、またはクラスター・チャネル (*SDR、*SVR、*CLUSSDR、または *CLUSRCVR) の長期再試行待機間隔を指定します。 これは、SHORTRTY で指定したカウントがゼロになった後、リモート・マシンとの接続を確立するために試行を繰り返すときの間隔を、秒単位で定義します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- long-retry-interval
- 0 以上 999999999 以下の範囲の値を指定します。
注: 実装上の理由により、使用できる最大再試行間隔は 999999 です。これより大きい値を指定しても、999999 として処理されます。
長期再試行カウント (LONGRTY)
チャネル・イニシエーターによって自動的に開始される送信側チャネル、サーバー・チャネル、またはクラスター・チャネル (*SDR、*SVR、*CLUSSDR、または *CLUSRCVR) の長期再試行カウントを指定します。 SHORTRTY によって指定されたカウントが使い果たされた後に、LONGTMR によって指定された間隔で、リモート・マシンへの接続のために行われるそれ以降の試行の最大回数を定義します。 定義された試行回数の後、接続が設立されない場合には、エラー・メッセージがログに記録されます。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- 長期再試行カウント
- 0 以上 999999999 以下の範囲の値を指定します。 値 0 は、再試行が許可されないことを意味します。
セキュリティー出口 (SCYEXIT)
セキュリティー出口として呼び出されるプログラムの名前を指定します。 非ブランク名が定義された場合には、出口は以下の時点で呼び出されます。
- チャネルが確立された直後。
いかなるメッセージ転送も行われないうちに、この出口には、セキュリティー・フローを開始し、接続許可の妥当性を検査することができます。
- セキュリティー・メッセージ・フローへの応答を受信した時。
リモート・マシン上のリモート・プロセッサーからセキュリティー・メッセージ・フローを受け取った場合、そのフローは出口に渡されます。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- セキュリティー出口プログラムは呼び出されません。
- セキュリティー出口名
- セキュリティー出口プログラムの名前を指定します。
- library-name
- 出口プログラムが含まれているライブラリーの名前を指定します。 このパラメーターは、出口プログラム名が指定された場合は必須です。
セキュリティー出口 (CSCYEXIT)
クライアント・セキュリティー出口として呼び出されるプログラムの名前を指定します。 非ブランク名が定義された場合には、出口は以下の時点で呼び出されます。
- チャネルが確立された直後。
いかなるメッセージ転送も行われないうちに、この出口には、セキュリティー・フローを開始し、接続許可の妥当性を検査することができます。
- セキュリティー・メッセージ・フローへの応答を受信した時。
リモート・マシン上のリモート・プロセッサーからセキュリティー・メッセージ・フローを受け取った場合、そのフローは出口に渡されます。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- クライアント・セキュリティー出口プログラムは呼び出されません。
- セキュリティー出口名
- クライアント・セキュリティー出口プログラムの名前を指定します。
セキュリティー出口ユーザー・データ (SCYUSRDATA)
セキュリティー出口プログラムに渡される最大 32 文字のユーザー・データを指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- セキュリティー出口プログラムのユーザー・データは指定されません。
- セキュリティー出口ユーザー・データ
- セキュリティー出口のユーザー・データを指定します。
送信出口 (SNDEXIT)
送信出口として呼び出されるプログラムの入り口点を指定します。 非ブランクの名前を定義した場合、出口が即時に起動され、その後データがネットワークに送り出されます。 送信前に出口に送信バッファー全体が渡されます。バッファーの内容は、必要に応じて変更可能です。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- 送信出口プログラムは呼び出されません。
- 送信出口名
- 送信出口プログラムの名前を指定します。
- library-name
- 出口プログラムが含まれているライブラリーの名前を指定します。 このパラメーターは、出口プログラム名が指定された場合は必須です。
送信出口 (CSNDEXIT)
クライアント送信出口として呼び出されるプログラムの入り口点を指定します。 非ブランクの名前を定義した場合、出口が即時に起動され、その後データがネットワークに送り出されます。 送信前に出口に送信バッファー全体が渡されます。バッファーの内容は、必要に応じて変更可能です。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- クライアント送信出口プログラムは呼び出されません。
- 送信出口名
- クライアント送信出口プログラムの名前を指定します。
送信出口ユーザー・データ (SNDUSRDATA)
送信出口プログラムに渡される最大 32 文字のユーザー・データを指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- 送信出口プログラムのユーザー・データは指定されません。
- 送信出口ユーザー・データ
- 送信出口プログラムのユーザー・データを指定します。
受信出口 (RCVEXIT)
受信出口として呼び出されるプログラムの入り口点を指定します。 非ブランクの名前を定義した場合、ネットワークから受信したデータが処理される前に出口が 起動されます。ネットワークに送り出されます。 出口に送信バッファー全体が渡されます。バッファーの内容は、必要に応じて変更可能です。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- 受信出口プログラムは呼び出されません。
- 受信出口名
- 受信出口プログラムの名前を指定します。
- library-name
- 出口プログラムが含まれているライブラリーの名前を指定します。 このパラメーターは、出口プログラム名が指定された場合は必須です。
受信出口 (CRCVEXIT)
クライアント受信出口として呼び出されるプログラムの入り口点を指定します。 非ブランクの名前を定義した場合、ネットワークから受信したデータが処理される前に出口が 起動されます。ネットワークに送り出されます。 出口に送信バッファー全体が渡されます。バッファーの内容は、必要に応じて変更可能です。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- クライアント受信出口プログラムは呼び出されません。
- 受信出口名
- クライアント受信出口プログラムの名前を指定します。
受信出口ユーザー・データ (RCVUSRDATA)
受信出口プログラムに渡される最大 32 文字のユーザー・データを指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- 受信出口プログラムのユーザー・データは指定されません。
- 受信出口ユーザー・データ
- 受信出口プログラムの最大 32 文字のユーザー・データを指定します。
メッセージ出口 (MSGEXIT)
メッセージ出口として呼び出されるプログラムの入り口点を指定します。 非ブランクの名前を定義した場合、メッセージが伝送キューから取り出された後、出口が即時に起動されます。 出口にアプリケーション・メッセージおよびメッセージ記述子全体が渡され、変更されます。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- メッセージ出口プログラムは呼び出されません。
- メッセージ出口名
- メッセージ出口プログラムの名前を指定します。
- library-name
- 出口プログラムが含まれているライブラリーの名前を指定します。 このパラメーターは、出口プログラム名が指定された場合は必須です。
*CLTCN または *SVRCN のチャネル・タイプ (CHLTYPE) では、 このパラメーターを指定することはできません。
メッセージ出口ユーザー・データ (MSGUSRDATA)
メッセージ出口プログラムに渡されるユーザー・データを指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- メッセージ出口プログラムのユーザー・データは指定されません。
- メッセージ出口ユーザー・データ
- メッセージ出口プログラムに渡される最大 32 文字のユーザー・データを指定します。
*CLTCN または *SVRCN のチャネル・タイプ (CHLTYPE) では、 このパラメーターを指定することはできません。
メッセージ再試行出口 (MSGRTYEXIT)
メッセージ再試行出口として呼び出されるプログラムの入り口点を指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- メッセージ再試行出口プログラムは呼び出されません。
- メッセージ再試行出口名
- メッセージ再試行出口プログラムの名前を指定します。
- library-name
- 出口プログラムが含まれているライブラリーの名前を指定します。 このパラメーターは、出口プログラム名が指定された場合は必須です。
*SDR、*SVR、*CLTCN、*SVRCN、または *CLUSSDR のチャネル・タイプ (CHLTYPE) では、このパラメーターを指定することはできません。
メッセージ再試行出口データ (MSGRTYDATA)
メッセージ再試行出口プログラムに渡されるユーザー・データを指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- メッセージ再試行出口プログラムのユーザー・データは指定されません。
- message-retry-exit-user-data
- メッセージ再試行出口プログラムに渡される最大 32 文字のユーザー・データを指定します。
*SDR、*SVR、*CLTCN、*SVRCN、または *CLUSSDR のチャネル・タイプ (CHLTYPE) では、このパラメーターを指定することはできません。
メッセージ再試行回数 (MSGRTYNBR)
メッセージを配布できないと判断するまでチャネルが再試行する回数を指定します。
チャネルは、MSGRTYEXIT が *NONE として定義されている場合に、このパラメーターをメッセージ再試行出口の代替として使用します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- message-retry-number
- 0から999999999の範囲の値を指定します。 値 0 は、再試行が実行されないことを示します。
*SDR、*SVR、*CLTCN、*SVRCN、または *CLUSSDR のチャネル・タイプ (CHLTYPE) では、このパラメーターを指定することはできません。
メッセージ再試行間隔 (MSGRTYITV)
チャネルが MQPUT 操作を再試行できようになるまでに経過する必要がある最小間隔 (時間) を指定します。 この時間の単位はミリ秒です。
チャネルは、MSGRTYEXIT が *NONE として定義されている場合に、このパラメーターをメッセージ再試行出口の代替として使用します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- message-retry-number
- 0から999999999の範囲の値を指定します。 値 0 は、できるだけ早く再試行が実行されることを示します。
*SDR、*SVR、*CLTCN、*SVRCN、または *CLUSSDR のチャネル・タイプ (CHLTYPE) では、このパラメーターを指定することはできません。
メッセージ変換 (CVTMSG)
メッセージを送信する前に、メッセージ内のアプリケーション・データを変換する必要があるかどうかを指定します。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- *YES
- メッセージ中のアプリケーション・データは送信前に変換されます。
- *NO
- メッセージ中のアプリケーション・データは、送信前に変換されません。
*RCVR、*RQSTR、*CLTCN、または *SVRCN のチャネル・タイプ (CHLTYPE) では、 このパラメーターを指定することはできません。
書き込み権限 (PUTAUT)
宛先キューにメッセージを書き込む権限を確立するために、メッセージに関連付けられたコンテキスト情報のユーザー ID を使用するどうかを指定します。 これは、受信側および要求側 (*CLUSRCVR、*RCVR、および *RQSTR) のチャネルにのみ適用されます。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *DFT
- メッセージを宛先キューに書き込む前に権限検査は行われません。
- *CTX
- メッセージを書き込む権限を確立するために、メッセージ・コンテキスト情報のユーザー ID が使用されます。
*SDR、*SVR、*CLTCN、*SVRCN、または *CLUSSDR のチャネル・タイプ (CHLTYPE) では、このパラメーターを指定することはできません。
シーケンス番号の折り返し (SEQNUMWRAP)
最大メッセージ・シーケンス番号を指定します。 最大値に到達すると、シーケンス番号は折り返して再度 1 から始まります。
注: 最大メッセージ・シーケンス番号は折衝可能ではありません。ローカル・チャネルとリモート・チャネルは、同じ番号で折り返す必要があります。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- sequence-number-wrap-value
- 100 から 999999999 の範囲の値を指定します。
*CLTCN または *SVRCN のチャネル・タイプ (CHLTYPE) では、 このパラメーターを指定することはできません。
最大メッセージ長 (MAXMSGLEN)
チャネル上で送信可能な最大メッセージ長を指定します。 この値は、リモート・チャネルの値と比較され、実際の最大長は、2 つの値のうちの小さいほうの値になります。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- 最大メッセージ長
- 0 から 104857600 の範囲の値を指定します。 値 0 は、最大長が無制限であることを示します。
ハートビート間隔 (HRTBTINTVL)
伝送キューにメッセージがないときに、送信 MCA から渡されるハートビート・フロー間の時間 (秒数) を指定します。 ハートビート交換は、受信 MCA にチャネルを静止する機会を提供します。 これは、送信側、サーバー、クラスター送信側、およびクラスター受信側 (*SDR、*SVR、*CLUSSDR、および *CLUSRCVR) チャネルにのみ適用されます。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- heart-beat-interval
- 0から999999999の範囲の値を指定します。 値 0 は、ハートビート交換が行われないことを意味します。
非永続メッセージ速度 (NPMSPEED)
チャネルが高速非持続メッセージをサポートするかどうかを指定します。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- *FAST
- チャネルは高速非持続メッセージをサポートします。
- *NORMAL
- チャネルは高速非持続メッセージをサポートしません。
*CLTCN または *SVRCN のチャネル・タイプ (CHLTYPE) では、 このパラメーターを指定することはできません。
クラスター名 (CLUSTER)
チャネルが所属するクラスターの名前。 最大長は、MQ オブジェクトの命名規則に準拠した 48 文字です。
このパラメーターは、*CLUSSDR チャネルおよび *CLUSRCVR チャネルの場合にのみ有効です。 CLUSNL パラメーターが非ブランクの場合には、このパラメーターはブランクでなければなりません。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- *NONE 値
- クラスター名は指定されません。
- cluster-name
- チャネルが所属するクラスターの名前。 最大長は、MQ オブジェクトの命名規則に準拠した 48 文字です。
クラスター名リスト (CLUSNL)
チャネルが属するクラスターのリストを指定する名前リストの名前です。
このパラメーターは、*CLUSSDR チャネルおよび *CLUSRCVR チャネルの場合にのみ有効です。 CLUSTER パラメーターが非ブランクの場合には、このパラメーターはブランクでなければなりません。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- *NONE 値
- クラスター名前リストは指定されません。
- cluster-name-list
- チャネルが属するクラスターのリストを指定する名前リストの名前です。 最大長は、MQ オブジェクトの命名規則に準拠した 48 文字です。
ネットワーク接続優先順位 (NETPRTY)
ネットワーク接続の優先順位。 分散キューイングでは、使用可能な複数のパスがある場合、優先度が最も高いパスが選択されます。 値は 0 から 9 の範囲内でなければなりません。0 が最低優先順位です。
このパラメーターは、*CLUSRCVR チャネルにのみ有効です。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- network-connection-priority
- 0 から 9 の範囲の値を指定します。0 が最低優先順位です。
TLS 暗号仕様 (SSLCIPH)
SSLCIPH は、TLS チャネル折衝で使用される暗号仕様を指定します。 指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- cipherspec
- 暗号仕様の名前です。
TLS クライアント認証 (SSLCAUTH)
SSLCAUTH は、チャネルがクライアント認証を TLS を介して実行するかどうかを指定します。 パラメーターは、SSLCIPH が指定されたチャネルにのみ使用されます。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- *REQUIRED
- クライアント認証は必須です。
- * オプション
- クライアント認証はオプションです。
*SDR、*CLTCN、または *CLUSSDR のチャネル・タイプ (CHLTYPE) では、このパラメーターを指定することはできません。
TLS ピア名 (SSLPEER)
SSLPEER は、TLS チャネル折衝で使用される X500 ピア名を指定します。 指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- x500peername
- 使用する X500 ピア名です。
ローカル通信アドレス (LOCLADDR)
チャネルのローカル通信アドレスを指定します。
このパラメーターは、*SDR、*SVR、*RQSTR、*CLUSSDR、*CLUSRCVR、および *CLTCN チャネルにのみ有効です。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- 接続はブランクです。
- local-address
- トランスポート・タイプ TCP/IP にのみ有効です。 アウトバウンド TCP/IP 通信に使用するオプションの IP アドレスと、オプションのポートまたはポート範囲を指定してください。 形式は次のとおりです。
LOCLADDR([ip-addr][(low-port[,high-port])][,[ip-addr][(low-port[,high-port])]])
バッチ・ハートビート間隔 (BATCHHB)
バッチ・ハートビートがこのチャネルで発生するかどうかを決定するために使用される時間 (ミリ秒) です。 バッチ・ハートビートを使用すると、チャネルは、リモート・チャネル・インスタンスが未確定になる前に、まだアクティブであるかどうかを判別できます。 バッチ・ハートビートは、チャネル MCA が指定の時間内にリモート・チャネルと通信しなかった場合に発生します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- batch-heartbeat-interval
- 0から999999999の範囲の値を指定します。 値 0 は、バッチ・ハートビートを使用しないことを示します。
*RCVR、*RQSTR、*CLTCN、または *SVRCN のチャネル・タイプ (CHLTYPE) では、 このパラメーターを指定することはできません。
タスク・ユーザー ID (USERID)
メッセージ・チャネル・エージェントは、リモート・メッセージ・チャネル・エージェントとの間に安全な LU 6.2 セッションを開始しようとするとき、これを使用します。
チャネル・タイプ (CHLTYPE) が、*SDR、*SVR、*RQSTR、*CLTCN、または *CLUSSDR であるチャネルにのみ、このパラメーターは有効です。
属性の最大長は 12 文字ですが、最初の 10 文字のみが使用されます。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- *NONE 値
- ユーザー ID は指定されません。
- ユーザー ID
- タスク・ユーザー ID を指定します。
パスワード (PASSWORD)
メッセージ・チャネル・エージェントは、リモート・メッセージ・チャネル・エージェントとの間に安全な LU 6.2 セッションを開始しようとするとき、これを使用します。
チャネル・タイプ (CHLTYPE) が、*SDR、*SVR、*RQSTR、*CLTCN、または *CLUSSDR であるチャネルにのみ、このパラメーターは有効です。
属性の最大長は 12 文字ですが、最初の 10 文字のみが使用されます。
指定できる値は以下のとおりです。
- *SAME
- この属性の値は変更されません。
- *NONE 値
- パスワードは指定されません。
- パスワード
- パスワードを指定します。
キープアライブ間隔 (KAINT)
このチャネルのキープアライブの時間間隔を指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *AUTO
- キープアライブ間隔は、折衝されたハートビート値に基づいて次のように計算されます。
- 折衝された HBINT が 0 より大きい場合、キープアライブ間隔はその値プラス 60 秒に設定されます。
- 折衝された HBINT が 0 の場合、使用される値は TCP プロファイル構成データ・セットの KEEPALIVEOPTIONS ステートメントで指定された値です。
- keep-alive-interval
- 0 から 99999 の範囲の値を指定します。
ヘッダー圧縮 (COMPHDR)
チャネルでサポートされるヘッダー・データ圧縮技法のリスト。
チャネル・タイプが、送信側、サーバー、クラスター送信側、クラスター受信側、およびクライアント接続 (*SDR、*SVR、*CLUSSDR、*CLUSRCVR、および *CLTCN) の場合、指定された値は、使用中のチャネルのリモート・エンドがサポートする圧縮技法を最優先とする順になっています。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- ヘッダー・データ圧縮は実行されません。
- * システム
- ヘッダー・データ圧縮が実行されます。
メッセージ圧縮 (COMPMSG)
チャネルでサポートされるメッセージ・データ圧縮技法のリスト。
チャネル・タイプが、送信側、サーバー、クラスター送信側、クラスター受信側、およびクライアント接続 (*SDR、*SVR、*CLUSSDR、*CLUSRCVR、および *CLTCN) の場合、指定された値は、使用中のチャネルのリモート・エンドがサポートする圧縮技法を最優先とする順になっています。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *NONE 値
- メッセージ・データ圧縮は実行されません。
- *RLE
- ラン・レングス・エンコードを使用してメッセージ・データ圧縮が実行されます。
- *ZLIBFAST
- zlib 圧縮手法を使用してメッセージ・データ圧縮が実行されます。 高速圧縮時間を推奨します。
- *ZLIBHIGH
- zlib 圧縮手法を使用してメッセージ・データ圧縮が実行されます。 ハイレベル圧縮を推奨します。
- *ANY
- キュー・マネージャーでサポートされるすべての圧縮技法を使用できます。 このオプションは、受信側、要求側、およびサーバー接続 (*RCVR、*RQSTR、および *SVRCN) のチャネル・タイプにのみ有効です。
チャネル・モニター (MONCHL)
オンライン・モニター・データの収集を制御します。
キュー・マネージャー属性 MONCHL が *NONE に設定されていると、オンライン・モニター・データは収集されません。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *QMGR
- オンライン・モニター・データの収集は、キュー・マネージャー属性 MONCHL の設定から継承されます。
- *OFF
- このチャネルのオンライン・モニター・データ収集は無効になります。
- *LOW
- モニター・データ収集は、低いデータ収集率でオンとなります。
- *MEDIUM
- モニター・データ収集は、普通のデータ収集率でオンとなります。
- *HIGH
- モニター・データ収集は、高いデータ収集率でオンとなります。
チャネル・タイプ (CHLTYPE) が *CLTCN の場合、このパラメーターを指定することはできません。
チャネル統計 (STATCHL)
統計データの収集を制御します。
キュー・マネージャー属性 STATCHL が *NONE に設定されていると、統計データは収集されません。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *QMGR
- 統計データの収集は、キュー・マネージャー属性 STATCHL の設定に基づいて行われます。
- *OFF
- このチャネルの統計データ収集は、無効になります。
- *LOW
- 統計データ収集は、低いデータ収集率でオンとなります。
- *MEDIUM
- 統計データ収集は、普通のデータ収集率でオンとなります。
- *HIGH
- 統計データ収集は、高いデータ収集率でオンとなります。
*CLTCN または *SVRCN のチャネル・タイプ (CHLTYPE) では、 このパラメーターを指定することはできません。
クラスター・ワークロード・ランク (CLWLRANK)
チャネルのクラスター・ワークロード・ランクを指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- cluster-workload-rank
- チャネルのクラスター・ワークロード・ランクで、範囲は 0 から 9 までです。
クラスター・ワークロード優先順位 (CLWLPRTY)
チャネルのクラスター・ワークロード優先順位を指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- cluster-workload-priority
- チャネルのクラスター・ワークロード優先順位で、範囲は 0 から 9 までです。
クラスター・チャネル・ウェイト (CLWLWGHT)
チャネルのクラスター・ワークロード・ウェイトを指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- cluster-workload-weight
- チャネルのクラスター・ワークロード・ウェイトで、範囲は 1 から 99 までです。
共有会話 (SHARECNV)
特定の TCP/IP クライアント・チャネル・インスタンス (ソケット) で共有できる会話の最大数を指定します。
このパラメーターは、CHLTYPE が *CLTCN または *SVRCN として定義されているチャネルの場合に有効です。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- 0
- TCP/IP ソケットで会話を共有しないように指定します。 チャネル・インスタンスは、以下の点に関して、 IBM WebSphere® MQ 7.0より前のモードで実行されます。
- 管理者の停止と静止
- ハートビート中
- 先読み
- 1
- TCP/IP ソケットで会話を共有しないように指定します。 MQGET 呼び出しであるかどうかにかかわらず、クライアントのハートビートおよび先読みが可能であり、チャネル静止がさらに制御しやすくなります。
- shared-conversations
- 2 から 999999999 の範囲の、共有会話の数。
このパラメーターは、クライアント接続およびサーバー接続のチャネルの場合にのみ有効です。
注: クライアント接続の SHARECNV 値がサーバー接続の SHARECNV 値と一致しない場合、2 つの値の小さいほうが使用されます。
プロパティー制御 (PROPCTL)
メッセージが V6 またはそれより前のキュー・マネージャー (プロパティー記述子の概念を理解しない キュー・マネージャー) に送信されるときに、メッセージのプロパティーに対して行われる処置を指定します。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *COMPAT
- メッセージに接頭部が「mcd.」のプロパティーが含まれている場合、 "jms.", 「usr.」 または 「mqext.」 メッセージがリモート・キュー・マネージャーに送信される前に、メッセージ記述子 (または拡張) 内のメッセージ・プロパティーを除くすべてのオプション・メッセージ・プロパティーが、メッセージ・データ内の 1 つ以上の MQRFH2 ヘッダーに入れられます。
- *NONE 値
- メッセージのすべてのプロパティー (メッセージ記述子または拡張子に含まれるプロパティーを除く) は、メッセージがリモート・キュー・マネージャーに送信される前に、メッセージから除去されます。
- *ALL
- メッセージのすべてのプロパティーは、メッセージがリモート・キュー・マネージャーに送られるときに、そのメッセージに組み込まれます。 メッセージ記述子 (または拡張) に含まれているプロパティーを除くすべてのプロパティーが、メッセージ・データの 1 つ以上の MQRFH2 ヘッダーに入れられます。
最大インスタンス (MAXINST)
このサーバー接続チャネル・オブジェクトを介してキュー・マネージャーに同時に接続できるクライアントの最大数を指定します。
この属性はサーバー接続チャネルにのみ有効です。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- maximum-instances
- チャネルの同時インスタンスの最大数で、範囲は 0 から 99999999 までです。
値 0 では、すべてのクライアント・アクセスができなくなります。 現在実行中のサーバー接続チャネルのインスタンス数を下回るまでこの値を削減すると、実行中のチャネルは影響を受けませんが、十分な数の既存のインスタンスが実行を停止するまでは新規のインスタンスを開始できなくなります。
クライアントあたりの最大インスタンス (MAXINSTC)
単一のクライアントから開始可能な、個々のサーバー接続チャネルの同時インスタンスの最大数を指定します。
このコンテキストでは、同じリモート・ネットワーク・アドレスを起点とする複数のクライアント接続は 1 つのクライアントと見なされます。
この属性はサーバー接続チャネルにのみ有効です。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- maximum-instances-per-client
- 単一のクライアントから開始可能な、チャネルの同時インスタンスの最大数で、範囲は 0 から 99999999 までです。
値 0 では、すべてのクライアント・アクセスができなくなります。 個々のクライアントから現在実行されているサーバー接続チャネルのインスタンス数を下回るまでこの値を削減すると、実行中のチャネルは影響を受けませんが、十分な数の既存のインスタンスが実行を停止するまでは新規のインスタンスを開始できなくなります。
クライアント・チャネル・ウェイト (CLNTWGHT)
適切な定義を複数使用できる場合、加重に基づいてクライアント・チャネル定義をランダムに選択できるように、クライアント・チャネルの加重属性が使用されます。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- client-channel-weight
- クライアント・チャネル・ウェイト。0 から 99 までの範囲となります。
接続アフィニティー (AFFINITY)
チャネル・アフィニティー属性を使用すると、同じキュー・マネージャー名を使用して複数回接続する クライアント・アプリケーションが、接続ごとに同じクライアント・チャネル定義を使用するかどうかを 選択できます。
指定できる値は以下のとおりです。
- *SAME
- 属性は変更されません。
- *PREFERRED
- クライアント・チャネル定義テーブル (CCDT) を読み取るプロセス内の最初の接続は、加重に基づいて適用可能な定義のリストを作成します。これは先頭が適用可能な CLNTWGHT(0) 定義で、アルファベット順です。 プロセス内の各接続は、リスト内の最初の定義を使用して接続を試行します。 接続が失敗した場合は、次の定義が使用されます。 失敗した非 CLNTWGHT(0) 定義は、リストの最後に移動されます。 CLNTWGHT(0) 定義は、リストの先頭に残り、各接続の最初に選択されます。
- *NONE 値
- CCDT を読み取るプロセス内の最初の接続が、適用可能な定義のリストを作成します。 プロセス内のすべての接続は、加重に基づいて適用可能な定義を選択します。適用可能な CLNTWGHT(0) の定義を最初にアルファベット順に選択していきます。
バッチ・データ制限 (BATCHLIM)
同期点をとるまでに、1 つのチャネルを介して送信可能なデータ量 (キロバイト) の限度を指定します。 限度に達した際のメッセージがチャネルを通って送信された後に、同期点が取られます。 この属性の値がゼロの場合、それはこのチャネルに対するバッチに適用されるデータ限度がないことを意味します。
- BATCHSZ メッセージが送信されました。
- BATCHLIM バイトが送信されました。
- 伝送キューが空で、BATCHINT が経過した。
このパラメーターは、チャネル・タイプ (CHLTYPE) が SDR、SVR、CLUSSDR、 または CLUSRCVR のチャネルにのみ有効です。
値は 0 から 999999 の範囲でなければなりません。 デフォルト値は 5000 です。
BATCHLIM パラメーターは、すべてのプラットフォームでサポートされます。
- *SAME
- この属性の値は変更されません。
- batch-data-limit
- 0 から 999999 の範囲の値を指定します。
このパラメーターは、*SDR、*SVR、*CLUSSDR、または *CLUSRCVR のチャネル・タイプ (CHLTYPE) にだけ指定できます。
デフォルトのクライアント再接続 (DFTRECON)
クライアント接続がクライアント・アプリケーションへの接続から切断した場合に、自動的に再接続するかどうかを指定します。- *SAME
- この属性の値は変更されません。
- *NO
- MQCONNXによってオーバーライドされない限り、クライアントは自動的に再接続されません。
- *YES
- MQCONNXによってオーバーライドされない限り、クライアントは自動的に再接続します。
- *QMGR
- MQCONNX でオーバーライドされない限り、
クライアントは、同じキュー・マネージャーに対してのみ自動的に再接続します。 QMGR オプションは
MQCNO_RECONNECT_Q_MGRと同じ効果があります。 - *DISABLED
- MQCONNX MQI 呼び出しを使用してクライアント・プログラムによって要求された場合でも、再接続は無効になります。
このパラメーターは、クライアント接続チャネル (CHLTYPE) *CLTCN で指定されます。