2.2.1 MQCクライアント機能の環境変数
UNIXの場合,MQCクライアント機能が使用する環境変数の設定形式は,MQCクライアント機能があるコンピュータのシェルによって異なります。
-
ボーンシェルを使用する場合は/etc/profileまたは$HOME/.profileに記述してください。
-
Cシェルを使用する場合は/etc/cshrcまたは$HOME/.cshrcに記述してください。
Java言語のJMSインタフェースを使用する場合は,uCosminexus Application Server上でリソースアダプタのプロパティ定義に次の環境変数を設定してください。
- 〈この項の構成〉
(1) ボーンシェルを使用する場合の形式(UNIX)
$ DCMQCSRVHOSTNAME = 窓口となるMQCリスナサーバのホスト名 $ DCMQCSRVHOSTIP = 窓口となるMQCリスナサーバのIPアドレス $ DCMQCSRVSERVNAME = 窓口となるMQCリスナサーバのサービス名 $ DCMQCSRVPORT = 窓口となるMQCリスナサーバのポート番号 〔$ DCMQCCLTHOSTIP = 自システムのIPアドレス〕 〔$ DCMQCCLTPORT = 自システムのポート番号〕 〔$ DCMQCTIMEREQ = MQCリスナサーバまたはMQCゲートウェイサーバからの 結果応答受信監視タイマ値〕 〔$ DCMQCTIMEGET = MQCゲートウェイサーバでのMQGET命令の 待ち合わせ最大時間〕 〔$ DCMQCTIMESEG = MQCリスナサーバまたはMQCゲートウェイサーバからの 継続セグメント受信監視タイマ値〕 〔$ DCMQCTIMECON = MQCリスナサーバまたはMQCゲートウェイサーバへの 最大接続試行時間〕 〔$ DCMQCSEGSIZE = 転送時のセグメントサイズ〕 〔$ DCMQCAPITRCOUT = APIトレースディスク出力要否〕 〔$ DCMQCAPITRCFILNUM = APIトレースファイル数〕 〔$ DCMQCAPITRCSIZE = APIトレース容量(エントリ数)〕 〔$ DCMQCAPITRCWRITE = APIトレース出力単位(エントリ数)〕 〔$ DCMQCEXPTRN = トランザクション処理方式の拡張要否〕 〔$ DCMQCDEFCON = 接続先情報定義ファイル読み込み要否〕 〔$ DCMQCDEFCONPATH = 接続先情報定義ファイルのパス〕 $ export DCMQCSRVHOSTNAME DCMQCSRVHOSTIP DCMQCSRVSERVNAME DCMQCSRVPORT DCMQCCLTHOSTIP DCMQCCLTPORT DCMQCTIMEREQ DCMQCTIMEGET DCMQCTIMESEG DCMQCTIMECON DCMQCSEGSIZE DCMQCAPITRCOUT DCMQCAPITRCFILNUM DCMQCAPITRCSIZE DCMQCAPITRCWRITE DCMQCEXPTRN DCMQCDEFCON DCMQCDEFCONPATH
(2) Cシェルを使用する場合の形式(UNIX)
% setenv DCMQCSRVHOSTNAME 窓口となるMQCリスナサーバのホスト名 % setenv DCMQCSRVHOSTIP 窓口となるMQCリスナサーバのIPアドレス % setenv DCMQCSRVSERVNAME 窓口となるMQCリスナサーバのサービス名 % setenv DCMQCSRVPORT 窓口となるMQCリスナサーバのポート番号 〔% setenv DCMQCCLTHOSTIP 自システムのIPアドレス〕 〔% setenv DCMQCCLTPORT 自システムのポート番号〕 〔% setenv DCMQCTIMEREQ MQCリスナサーバまたはMQCゲートウェイサーバ からの結果応答受信監視タイマ値〕 〔% setenv DCMQCTIMEGET MQCゲートウェイサーバでのMQGET命令の 待ち合わせ最大時間〕 〔% setenv DCMQCTIMESEG MQCリスナサーバまたはMQCゲートウェイサーバ からの継続セグメント受信監視タイマ値〕 〔% setenv DCMQCTIMECON = MQCリスナサーバまたはMQCゲートウェイサーバへの 最大接続試行時間〕 〔% setenv DCMQCSEGSIZE 転送時のセグメントサイズ〕 〔% setenv DCMQCAPITRCOUT APIトレースディスク出力要否〕 〔% setenv DCMQCAPITRCFILNUM APIトレースファイル数〕 〔% setenv DCMQCAPITRCSIZE APIトレース容量(エントリ数)〕 〔% setenv DCMQCAPITRCWRITE APIトレース出力単位(エントリ数)〕 〔% setenv DCMQCEXPTRN トランザクション処理方式の拡張要否〕 〔% setenv DCMQCDEFCON 接続先情報定義ファイル読み込み要否〕 〔% setenv DCMQCDEFCONPATH 接続先情報定義ファイルのパス〕
(3) JMSインタフェース使用時の環境変数の設定
JMSインタフェースを使用する場合は,(1)〜(2)で示したMQCクライアント機能の環境変数に加えて,JMSインタフェース専用の環境変数を設定する必要があります。この設定では,uCosminexus Application Serverでリソースアダプタのプロパティ定義に設定します。詳細については,マニュアル「Cosminexus V9 アプリケーションサーバ アプリケーション設定操作ガイド」を参照してください。
(a) デプロイおよびアンデプロイ時の注意事項(JMSインタフェース使用時)
-
TP1/Message Queue Accessのリソースアダプタをインポートするには,リソースアダプタのインポートでmqcadpt.rarファイルを指定します。mqcadpt.rarファイルは,TP1/Message Queue Access製品のインストール先のlibディレクトリに格納されています。
-
TP1/Message Queue Accessのリソースアダプタは,アプリケーションデプロイして使用することはできません。また,複数デプロイして使用することもできません。
-
TP1/Message Queue Accessのリソースアダプタが出力するメッセージは,すべてログファイルに書き込まれます。ログを出力するかどうかは,「リソースアダプタのプロパティ定義」−「実行時のプロパティ」で設定できます。設定する場合は,必ずログを出力する設定にしてください。
-
TP1/Message Queue Accessのリソースアダプタをデプロイしたあとに削除する場合は,サーバを再起動してから削除してください。
-
TP1/Message Queue Access製品のリプレースなどで,TP1/Message Queue Access製品を削除する場合は,削除する前に必ずTP1/Message Queue Accessのリソースアダプタをエクスポートしてください。エクスポートの操作については,マニュアル「Cosminexus V9 アプリケーションサーバ アプリケーション設定操作ガイド」を参照してください。
なお,TP1/Message Queue AccessのリソースアダプタをスタートしたあとにTP1/Message Queue Access製品を削除するとエラーになります。この場合は,サーバを再起動してからTP1/Message Queue Access製品を削除してください。
(b) 環境変数の設定項目(JMSインタフェース使用時)
JMSインタフェースを使用する場合に設定する必要がある環境変数を次の表に示します。
分類 |
設定項目 |
設定する内容 |
---|---|---|
MQCクライアント機能共通 |
窓口となるMQCリスナサーバのホスト名 |
|
窓口となるMQCリスナサーバのIPアドレス |
||
窓口となるMQCリスナサーバのサービス名 |
||
窓口となるMQCリスナサーバのポート番号 |
||
自システムのIPアドレス |
||
自システムのポート番号 |
||
MQCリスナサーバまたはMQCゲートウェイサーバからの結果応答受信監視タイマ値 |
||
MQCゲートウェイサーバでのMQGET命令の待ち合わせ最大時間 |
||
MQCリスナサーバまたはMQCゲートウェイサーバからの継続セグメント受信監視タイマ値 |
||
MQCリスナサーバまたはMQCゲートウェイサーバへの最大接続試行時間 |
||
転送時のセグメントサイズ |
||
APIトレースディスク出力要否 |
||
APIトレースファイル数 |
||
APIトレース容量(エントリ数) |
||
APIトレース出力単位(エントリ数) |
||
JMSインタフェース専用 |
TemporaryQueueオブジェクト生成時のモデルキュー定義 |
|
JMSAPIトレース情報の出力レベル |
||
JMSPRFトレース情報の取得レベル |
||
キュー定義ファイル名 |
||
ユーザトランザクション開始と同時にMQCサーバでトランザクションを開始するかどうか |
- 注
-
JMSインタフェースを使用する場合のMQCクライアント機能の環境変数の型は次のとおりです。
-
TraceLevelおよびPrfTraceLevel:java.lang.Integer型
-
その他の環境変数:すべてjava.lang.String型
-
(4) 環境変数の設定場所の有効性
接続先情報定義ファイルを読み込むかどうかによって,有効になる環境変数の設定場所が異なります。接続先情報定義ファイルを読み込む(DCMQCDEFCON=Y)場合,および接続先情報定義ファイルを読み込まない(DCMQCDEFCON=N)場合の,環境変数の設定場所の有効性を次の表に示します。
環境変数名 |
指定する内容 |
DCMQCDEFCON=Y |
DCMQCDEFCON=N |
||
---|---|---|---|---|---|
接続先情報定義ファイル |
OSに設定する環境変数 |
接続先情報定義ファイル |
OSに設定する環境変数 |
||
接続先情報定義ファイル読み込み要否 |
− |
○ |
− |
○ |
|
接続先情報定義ファイルのパス |
− |
○ |
− |
− |
|
接続先のMQサーバのキューマネジャ名 |
○ |
− |
− |
− |
|
窓口となるMQCリスナサーバのホスト名 |
○ |
− |
− |
○ |
|
窓口となるMQCリスナサーバのIPアドレス |
○ |
− |
− |
○ |
|
窓口となるMQCリスナサーバのサービス名 |
○ |
− |
− |
○ |
|
窓口となるMQCリスナサーバのポート番号 |
○ |
− |
− |
○ |
|
自システムのIPアドレス |
○ |
− |
− |
○ |
|
自システムのポート番号 |
○ |
− |
− |
○ |
|
MQCリスナサーバまたはMQCゲートウェイサーバからの結果応答受信監視タイマ値 |
○ |
− |
− |
○ |
|
MQCゲートウェイサーバでのMQGET命令の待ち合わせ最大時間 |
○ |
− |
− |
○ |
|
MQCリスナサーバまたはMQCゲートウェイサーバからの継続セグメント受信監視タイマ値 |
○ |
− |
− |
○ |
|
MQCリスナサーバまたはMQCゲートウェイサーバへの最大接続試行時間 |
○ |
− |
− |
○ |
|
転送時のセグメントサイズ |
○ |
− |
− |
○ |
|
APIトレースディスク出力要否 |
− |
○ |
− |
○ |
|
APIトレースファイル数 |
− |
○ |
− |
○ |
|
APIトレース容量(エントリ数) |
− |
○ |
− |
○ |
|
APIトレース出力単位(エントリ数) |
− |
○ |
− |
○ |
|
トランザクション処理方式の拡張要否 |
− |
○ |
− |
○ |