6.12.1 Message Queueアダプタ実行環境プロパティファイル
- 〈この項の構成〉
(1) 形式
[message.level={0|10|20}] [trace.level={0|10|20|30}] [methodtracefile.size=メソッドトレースの出力サイズ] [methodtracefile.num=メソッドトレースの出力面数] [datatracefile.size=データトレースの出力サイズ] [datatracefile.num=データトレースの出力面数] codetable.path=変換テーブル格納パス [exptracefile.size=例外ログの出力サイズ] [exptracefile.num=例外ログの出力面数] [transaction.local={true|false}]
(2) 機能
Message Queueアダプタが実行環境で動作する際に出力される,ログやトレースの情報を定義します。
Message Queueアダプタ実行環境プロパティファイルは次の手順で作成してください。
-
次のテンプレートファイルを基に,Message Queueアダプタ実行環境プロパティファイルを定義します。
<サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\MQ\config\templates\adpmq.properties
-
編集後のMessage Queueアダプタ実行環境プロパティファイルを次に示すファイル名で保存します。
<サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\MQ\config\<サービスID>.properties
Message Queueアダプタ実行環境プロパティファイルは,Message Queueアダプタの開始時に実行環境に反映されます。
Message Queueアダプタ実行環境プロパティファイルの内容を変更する場合は,Message Queueアダプタを停止してから変更してください。変更後は,変更内容を実行環境に反映するためにMessage Queueアダプタを再開始してください。
(3) 設定できるプロパティ
message.level={0|10|20} 〜<<10>>
メッセージログの出力レベルを指定します。メッセージログの出力レベルを次に示します。
情報種別 |
出力レベル |
||
---|---|---|---|
0 |
10 |
20 |
|
エラー情報 |
○ |
○ |
○ |
警告情報 |
△ |
○ |
○ |
インフォメーション |
△ |
△ |
○ |
trace.level={0|10|20|30} 〜<<10>>
メソッドトレースとデータトレースの出力レベルを指定します。
メソッドトレースの出力レベルを次に示します。
情報種別 |
出力レベル |
|||
---|---|---|---|---|
0 |
10 |
20 |
30 |
|
外部から呼び出されるメソッド情報およびメッセージ送信・受信入出力メソッドの開始・終了情報 |
× |
○ |
○ |
○ |
ほかのコンポーネントから参照するpublicメソッドの開始・終了情報 |
× |
× |
○ |
○ |
ほかのコンポーネントから参照しない内部メソッド(public以外のメソッド)の開始・終了情報 |
× |
× |
× |
○ |
メソッド内のエラー |
○ |
○ |
○ |
○ |
データトレースの出力レベルを次に示します。
情報種別 |
出力レベル |
|||
---|---|---|---|---|
0 |
10 |
20 |
30 |
|
メッセージ送受信要求データ情報 |
× |
× |
× |
○ |
メッセージ送受信応答データ情報 |
× |
× |
○ |
○ |
Fault情報のDetail情報 |
○ |
○ |
○ |
○ |
メッセージ送信失敗および受信メッセージのXML形式変換失敗 |
○ |
○ |
○ |
○ |
データトレースの出力レベルを20以上にした場合のメリットとデメリットを次に示します。メリット,デメリットを考慮して出力レベルを指定してください。
メリット・デメリット |
出力レベル |
|
---|---|---|
10 |
20以上 |
|
メリット |
|
メッセージ受信やメッセージ送受信要求が失敗した場合,ユーザデータが紛失するおそれがあります。 この場合,データトレースから復旧できます。 |
デメリット |
メッセージ受信やメッセージ送受信要求が失敗した場合,ユーザデータが紛失するおそれがあります。 この場合,紛失したユーザデータを回復できなくなります。 |
|
methodtracefile.size=メソッドトレースの出力サイズ 〜<符号なし数字>((4096−2147483647))<<4194304>>
Message Queueアダプタが取得するメソッドトレース情報の出力ファイルサイズを バイト単位で指定します。
methodtracefile.num=メソッドトレースの出力面数 〜<符号なし数字>((1−16))<<4>>
Message Queueアダプタが取得するメソッドトレース情報の出力ファイル面数を指定します。
datatracefile.size=データトレースの出力サイズ 〜<符号なし数字>((4096−2147483647))<<1048576>>
Message Queueアダプタが取得するデータトレース情報の出力ファイルサイズをバイト単位で指定します。
datatracefile.num=データトレースの出力面数 〜<符号なし数字>((1−16))<<4>>
Message Queueアダプタが取得するデータトレース情報の出力ファイル面数を指定します。
codetable.path=変換テーブル格納パス 〜<コード変換機能の変換テーブル(ユーザマッピングファイル)の格納パス>
コード変換機能の変換テーブル(ユーザマッピングファイル)の格納パスを指定します。Windowsの場合,パスのディレクトリ区切りは「\」ではなく,「\\」を使用してください。
バイナリ形式メッセージを送信する場合,要求電文に送信キュー特定情報または受信キュー特定情報を指定する場合は必ず指定してください。
ユーザマッピングファイルのカスタマイズの有無に応じて,次に示すパスを指定してください。
-
ユーザマッピングファイルをカスタマイズしないで標準値でのユーザマッピングファイルを利用する場合
<サービスプラットフォームのインストールディレクトリ>\CSC\lib\external\table
-
コード変換機能を利用して任意にカスタマイズしたユーザマッピングファイルを利用する場合
<コード変換機能の変換テーブル(ユーザマッピングファイル)の格納パス>
パスを指定する場合の注意事項を次に示します。
-
相対パス,親ディレクトリ表現(「..\」,「../」),カレントディレクトリ表現(「.\」,「./」)およびシンボリックリンクを含むパスは指定できません。
-
Windowsの場合,UNC形式,NTFSのストリーム名,および予約デバイス名を含むパスは指定しないでください。また,パスの大文字と小文字は区別されません。
-
パス長は,UTF-8への変換結果が1〜198バイトになるよう指定してください。
exptracefile.size=例外ログの出力サイズ 〜<数字>((4096−2147483647))<<4194304>>
Message Queueアダプタが取得する例外情報(スタックトレース)の出力ファイルサイズをバイト単位で指定します。
exptracefile.num=例外ログの出力面数 〜<数字>((1−16))<<4>>
Message Queueアダプタが取得する例外情報(スタックトレース)の出力ファイル面数を指定します。
transaction.local={true|false} 〜<<true>>
Message Queueアダプタで,トランザクション決着処理を実行するかどうか指定します。リソースアダプタのトランザクションサポートレベルにXATransactionを指定する場合は,falseを設定してください。
また,リソースアダプタのトランザクションサポートレベルにLocalTransactionを指定する場合,falseを指定していると,トランザクションの決着は,ビジネスプロセスのトランザクションをコミットするタイミングで実行されます。