分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/J編

[目次][索引][前へ][次へ]

2.11.4 エラートレースメモリトレース

エラートレース情報は,setErrorTraceModeメソッドのTrcPath引数で指定したディレクトリ,またはTP1/Client/J環境定義のdcerrtracepathオペランドで指定したディレクトリに,DCERR1.TRCおよびDCERR2.TRCというファイル名で出力されます。ファイルのサイズはsetErrorTraceModeメソッドのsize引数,またはTP1/Client/J環境定義のdcerrtracesizeオペランドで指定します。

エラートレースは,TP1/Client/Jが検知した障害をメッセージ形式でファイルに記録します。メソッド実行中に障害が発生した場合,その原因は例外として報告されますが,それだけでは原因を特定できない場合があります。エラートレースを取得すると,詳細なエラー情報がファイルに出力され,原因調査の資料として使用できます。

メモリトレースはエラートレースを取得できないJavaアプレットを使用しているときに,setTraceArrayメソッドで指定されたString配列にエラー情報を格納する機能です。障害発生時にString配列を参照するとエラー情報を取得できます。

エラートレースファイルの出力形式,またはメモリトレースのString配列への格納形式を次に示します。

 
(ttt)yyyy/mm/dd hh:mm:ss.uuu eeeeeeeeeeee
 

取得するメッセージを次の表に示します。

表2-42 エラートレース,メモリトレースで取得するメッセージ

メッセージの内容 意味
Invalid message received.
method=aaaaaaaa
TP1/Serverから不正なメッセージを受信しました。
aaaaaaaa:このメッセージを出力したメソッド名
メモリトレースの場合,このメッセージを出力したメソッド名に対応するコード
Error reply received.
inf=aaaaaaaa,
method=bbbbbbbb
TP1/Serverからエラー応答を受け取りました。
aaaaaaaa:受け取ったエラーコード
bbbbbbbb:このメッセージを出力したメソッド名
メモリトレースの場合,このメッセージを出力したメソッド名に対応するコード
Exception occured.
inf=aaaaaaaa,
exception=bbbbbbbb(cc...cc),
method=dddddddd
TP1Clientクラス内でJavaシステムから例外を受け取りました。またはTP1ClientクラスからJavaアプレット,Javaアプリケーション,またはJavaサーブレットに例外を返しました。
aaaaaaaa:例外が発生したときの保守情報
bbbbbbbb:Javaから受け取った例外名,またはJavaアプレット,Javaアプリケーション,またはJavaサーブレットに返した例外名
メモリトレースの場合,例外名に対応するコード
cc...cc:例外の詳細メッセージ
詳細メッセージがある場合だけ出力します。
dddddddd:このメッセージを出力したメソッド名
メモリトレースの場合,メソッド名に対応するコード
Invalid data received.
(aa...aa), method=bbbbbbbb
cltAssemReceiveメソッドで相手システムから不正なデータを受信しました。
aa...aa:不正なデータ
メッセージ長が不正な場合
receive message length=メッセージ長(10進数)
bbbbbbbb:このメッセージを出力したメソッド名
メモリトレースの場合,メソッド名に対応するコード
Receiving message was canceled.
aaaaaaaa (bb...bb) method=cccccccc
cltAssemReceiveメソッドで相手システムから受信したメッセージを破棄しました。
aaaaaaaa:メッセージを破棄した原因
bb...bb:データの内容
受信バッファオーバーフローの場合
receive buffer overflowed.
(receive buffer size=受信バッファの大きさ(10進数), receive message body length=受信メッセージ本体の長さ(10進数))
cccccccc:このメッセージを出力したメソッド名
メモリトレースの場合,メソッド名に対応するコード
User data did not compress,
group=aa...aa,
service=bb...bb,
reason= cc...cc
ユーザデータを圧縮しませんでした。データを圧縮しないでサービスを要求します。
aa...aa:要求先サービスグループ名
bb...bb:要求先サービス名
cc...cc:ユーザデータを圧縮しなかった理由
NO EFFECT:ユーザデータに対する圧縮効果がありません。
NOT SUPPORT VERSION:サービス要求先のTP1/Serverがデータ圧縮機能をサポートしていないバージョンです。
「NO EFFECT」の場合,圧縮前より圧縮後のデータの方が大きくなります。そのため,同一のCUPでほかにもこのメッセージが出力されていないか確認し,CUP単位でデータ圧縮機能を使用するかどうかを再度検討してください。
「NOT SUPPORT VERSION」の場合,サービス要求先のTP1/Serverが,データ圧縮機能を使用できるバージョン(TP1/Server Base 03-03以降)かどうかを確認してください。

メモリトレースに出力されるコードとメソッド名の対応を次の表に示します。

表2-43 コードとメソッド名の対応

コード メソッド名
1 TP1Client.openConnection
2 TP1Client.closeConnection
3 TP1Client.rpcCall
4 TP1Client.setDccltinquiretime
5 TP1Client.setDccltdelay
6 TP1Client.setDcwatchtim
7 TP1Client.setDcselint
8 TP1Client.setDccltextend
9 TP1Client.rpcOpen
10 TP1Client.rpcClose
11 TP1Client.setRpcextend
12 TP1Client.setDchost
13 TP1Client.rpcCallTo
14 TP1Client.trnBegin
15 TP1Client.trnChainedCommit
16 TP1Client.trnChainedRollback
17 TP1Client.trnUnchainedCommit
18 TP1Client.trnUnchainedRollback
19 TP1Client.trnInfo
20 TP1Client.getTrnID
37 TP1Client.cltAssemSend
38 TP1Client.cltAssemReceive
100 TP1ClientSocketCommunicator.openConnection
101 TP1ClientSocketCommunicator.closeConnection
102 TP1ClientSocketCommunicator.sendData
103 TP1ClientSocketCommunicator.sendData
104 TP1ClientSocketCommunicator.recvData
105 TP1ClientSocketCommunicator.recvData
106 TP1ClientSocketCommunicator.recvDummyData
107 TP1ClientSocketCommunicator.flush
108 TP1ClientSocketCommunicator.recvSelect
109 TP1ClientSocketCommunicator.openServerSocket
110 TP1ClientSocketCommunicator.acceptServerSocket
111 TP1ClientSocketCommunicator.closeServerSocket
112 TP1ClientSocketCommunicator.getServerPort
113 TP1ClientSocketCommunicator.getLocalIPAddress
114 TP1ClientSocketCommunicator.getLocalPort
300 TP1ClientProperties.TP1ClientProperties
301 TP1ClientProperties.TP1ClientProperties
302 TP1ClientProperties.getValue
400 TP1ClientRpc.rpcOpen
401 TP1ClientRpc.cltConnect
402 TP1ClientRpc.rpcCall
403 TP1ClientRpc.rpcClose
404 TP1ClientRpc.cltDisconnect
405 TP1ClientRpc.defAnalyze
406 TP1ClientRpc.rapConnect
407 TP1ClientRpc.rapDisconnect
408 TP1ClientRpc.rapRpcCall
409 TP1ClientRpc.scdRpcCall
410 TP1ClientRpc.setDccltextend
411 TP1ClientRpc.rapMngConnect
412 TP1ClientRpc.rapMngDisconnect
413 TP1ClientRpc.setRpcextend
414 TP1ClientRpc.setDchost
415 TP1ClientRpc.namRpcCall
416 TP1ClientRpc.getHostEntry
417 TP1ClientRpc.getNextEntry
500 TP1ClientConManage.openMngConnection
501 TP1ClientConManage.closeMngConnection
502 TP1ClientConManage.changeMngConnection
503 TP1ClientConManage.getConnection
504 TP1ClientConManage.putConnection
505 TP1ClientConManage.cancelConnection
506 TP1ClientConManage.registCheck
507 TP1ClientConManage.getMngConInfo
512 TP1ClientConManage.getSync
513 TP1ClientConManage.registConnNum
600 TP1ClientConnectionHost.addTP1ClientConnectionHost
601 TP1ClientConnectionHost.removeTP1ClientConnectionHost
602 TP1ClientConnectionHost.removeTP1ClientConnectionHostAll
603 TP1ClientConnectionHost.changeTP1ClientConnectionHost
604 TP1ClientConnectionHost.getConnection
605 TP1ClientConnectionHost.putConnection
606 TP1ClientConnectionHost.addConnection
700 TP1ClientNam.Lookup
900 TP1ClientTrn.trnBegin
901 TP1ClientTrn.trnChainedCommit
902 TP1ClientTrn.trnChainedRollback
903 TP1ClientTrn.trnUnchainedCommit
904 TP1ClientTrn.trnUnchainedRollback
905 TP1ClientTrn.conTrnCall
1001 Socket.Socket
1002 Socket.getInputStream
1003 Socket.getOutputStream
1004 Socket.close
1005 DataInputStream.read
1006 DataInputStream.available
1007 DataInputStream.close
1008 DataOutputStream.write
1009 DataOutputStream.close
1010 InetAddress.getLocalHost
1013 InputStream.read
1014 InputStream.close
1015 OutputStream.write
1016 OutputStream.close
1019 Socket.setTcpNoDelay
1102 TP1ClientSndRcv.cltAssemSend
1103 TP1ClientSndRcv.cltAssemReceive

メモリトレースに出力されるコードと例外名の対応を次の表に示します。

表2-44 コードと例外名の対応

コード 例外名
1 ErrInvalidArgsException
2 ErrProtoException
3 ErrNoBufsException
4 ErrNetDownException
5 ErrTimedOutException
6 ErrMessageTooBigException
7 ErrReplyTooBigException
8 ErrNoSuchServiceGroupException
9 ErrNoSuchServiceException
10 ErrServiceClosedException
11 ErrServiceTerminatingException
12 ErrServiceNotUpException
13 ErrNotUpException
14 ErrSyserrAtServerException
15 ErrNoBufsAtServerException
16 ErrSyserrException
17 ErrInvalidReplyException
18 ErrInitializingException
19 ErrServerBusyException
20 ErrTestmodeException
21 ErrSecchkException
22 ErrServiceTerminatedException
23 ErrIOErrException
24 ErrHostUndefException
25 ErrInvalidPortException
26 ErrConnfreeException
29 ErrFatalException
30 ErrSecurityException
31 NumberFormatException
32 EOFException
33 FileNotFoundException
34 SocketException
35 InterruptedIOException
36 ErrNotPoolingException
45 ErrTrnchkException
76 ErrServerTimedOutException
77 ErrClientTimedOutException
78 ErrNotTrnExtendException
79 ErrTrnchkExtendException
80 ErrNetDownAtServerException
81 ErrNetDownAtClientException
84 ErrInvalidMessageException
85 ErrBufferOverflowException
86 ErrCollisionMessageException
1001 IOException
1002 UnknownHostException