WMQ.Open Dynamicプログラムは、複数のキューマネジャーに対してクライアントモードで同時に接続できるようにします。
プログラムは、チャンネル名やWMQホストURL、およびチャンネルのリスナーポート番号に基づいてWMQとの接続をオープンします。プログラムはキューのハンドル値を返します。
パラメータ |
データ型 |
説明 |
Queue Manager |
文字 (48)/入力 |
MQ キューマネージャの名前 |
Queue Name |
文字 (48)/入力 |
通常のメッセージングに対してはオープンするキューの名前を指定します。パブリッシュやサブスクライブの場合は、ブローカ名を指定します。 |
Topic Name |
文字 (50)/入力 |
トピック名を指定します。パブリッシュとサブスクライブの場合のみ指定します。 |
Broker Stream |
文字 (50)/入力 |
ブローカストリームを指定します。パブリッシュとサブスクライブの場合のみ指定します。(例:SAMPLE.BROKER.RESULTS.STREAM) |
Queue Access Mode |
文字 (1)/入力 |
アクセスを表す文字
|
Share Mode |
文字 (1)/入力 |
キューの共有を表す文字列。
|
Fetch Order |
文字 (1)/入力 |
|
Message Fetch Mode |
文字 (1)/入力 |
読み込みメッセージの処理を指定します。
|
Participate in Broadcast |
論理値 (5)/入力 |
そのキューがメッセージブロードキャストに参加するかどうかを指定します。このパラメータは、メッセージ送信用にオープンしたキューのみ関係します。ブロードキャストを使用して、1つのメッセージが、パブリッシュのように、いくつかのオープンキューへ送信されます。 |
Subscription Scope |
文字 (1)/入力 |
サブスクリプションの有効範囲。 このパラメータはサブスクリプションのみ関係します。 指定できる値は以下の通りです。
|
Receive On Request |
論理値 (5)/入力 |
パブリケーションは、リクエストがあった場合のみ受信されます。このパラメータはパブリケーションのみ有効です。 |
Receive New |
論理値 (5)/入力 |
パブリケーションは、サブスクライビングを行う場合サブスクリプションが受信される前に送信します。このパラメータは、サブスクリプションのみ有効です。 |
Unsubscribe on Close Queue |
論理値 (5)/入力 |
このパラメータが「True」の場合、キューがクローズした時にコンポーネントが自動的にトピックから登録を取り消します。これは、コンポーネントがクローズするとトピックから登録を取り消すことを意味します。 |
Low-Hi order |
論理値 (5)/入力 (オプション) |
番号の語順が書き込まれ、昇順に読み込むかどうかを指定します。Windowsの規格では「True」 、UNIX の規格では、降順なので「False」 になります。このパラメータが渡されない時、フェッチされた値はグローバル設定から取得されます。詳細は、「環境設定」を参照してください。 |
Encoding |
数値 (1)/入力 |
文字項目のエンコードタイプ
|
Code Page |
数値 (5)/入力 (オプション) |
メッセージのエンコードで使用するコードページ。このパラメータが渡されない場合、フェッチされた値は、グローバル設定値から取得します。グローバルな値がグローバルセットアッププログラムか論理名で設定されていない場合、エラーが返されます。詳細は、「環境設定」を参照してください。 |
Correlation ID |
BLOB/入力: |
サブスクリプションのみ有効です。このパラメータは、確実にサブスクライブされたメッセージの受信のみのフィルタを定義します。 指定できる最大サイズは、24バイトです。 |
Msg Persistence |
文字 (1)/入力 |
そのメッセージがシステム障害に耐えられるかどうかを示します。 サブスクリプションのみ有効です。
|
Subscription period |
数値 (N10)/入力 |
メッセージの寿命をミリ秒で指定します。サブスクリプションのみ有効です。-1 の場合、無期限になります。 |
Disconnect on Close |
BLOB/入力 |
メッセージの読み込みと書込で関係します。キューがクローズされた後でMQサーバへの接続をクローズします。同じキューマネージャでオープンされている他のキューもクローズする場合がありますので注意してください。 |
Remote Queue Manager |
文字 (48)/入力 |
リモートキューマネージャの名前を指定します。このパラメータは、ローカルのキューマネージャへの接続時、指定されたリモートキューマネージャにメッセージを送信します。 |
Channel Name |
文字 (48)/入力 |
WebSphereクライアントに設定されたチャネル名を指定します。 |
MQ HOST |
文字 (100)/入力 |
WebSphere MQ ホストのURLを指定します。 |
Port |
数値 (6)/入力 |
チャネルのリスナーポート番号。指定は任意です。このパラメータを空白にした場合、デフォルトでWebSphere MQは1414などが設定されます。 |
戻り値 |
数値 (15) |
接続が成功した場合、キューハンドルが返されます。接続が成功しない場合は、負の値が返され、エラーがError Log に書き込まれます。 |