Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 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‒47 エラートレース,メモリトレースで取得するメッセージ

メッセージの内容

意味

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以降)かどうかを確認してください。

Hostname is invalid.

method=aa...aa,

operand=bb...bb,

value=cc...cc

  • ホスト名に不正がありました。次のうちのどれかの要因で,指定されたホスト名から名前解決ができません。

    a. hostsファイルやDNSなどでホスト名とIPアドレスをマッピングできない

    b. hostsファイルのアクセス権限がないため,参照できない

    c. 一時的なエラーによってDNSサーバへの問い合わせが失敗した

  • ループバックアドレス(127で始まるIPアドレス)もしくは,ループバックアドレスに変換されるホスト名を指定しています。

    localhostまたは名前解決した結果が127で始まるIPアドレス(例:127.0.0.1)に変換されるホスト名を指定しています。

  • オペランドに指定した10進ドット記法のIPアドレスに誤りがあります。

aa...aa:このメッセージを出力したメソッド名

bb...bb:エラーが発生したオペランド名

cc...cc:エラーが発生したオペランドの指定値

Definition analysis error occurred.

method=aa...aa,

operand=bb...bb

定義指定の論理エラーが発生しました。

aa...aa:このメッセージを出力したメソッド名

bb...bb:エラーが発生したオペランド名

dcresponsehost:dcnotifyreshostにYを指定した場合,dcresponsehostオペランドに指定が必要ですが,値が設定されていません。

Syntax error occurred.

method=aa...aa,

operand=bb...bb,

value=cc...cc

オペランドの指定値が規則に従っていません。

aa...aa:このメッセージを出力したメソッド名

bb...bb:エラーが発生したオペランド名

cc...cc:エラーが発生したオペランドの指定値

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

表2‒48 コードとメソッド名の対応

コード

メソッド名

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‒49 コードと例外名の対応

コード

例外名

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