2.9.2 UAPトレース

UAPトレースは,Client .NETが提供するメソッドの実行トレースとして,メソッドの開始時と終了時に次の情報を取得します。

注※
一部のメソッドを実行したときにUAPトレースに出力される情報です。詳細については,「2.9.7 TP1/Serverの性能検証用トレース」を参照してください。

送受信したデータの内容は,Callメソッドが受け渡したデータを取得します。なお,送受信データ長が60バイトを超える場合は,先頭の60バイトを取得します。クライアントスタブを使用している場合は,スタブが変換した送信データ,およびサーバから受信したデータが記録されます。

UAPトレースは,UAPおよびClient .NETのメソッド発行履歴を取得できるため,UAPのテストおよびデバッグに有効です。また,障害発生時の問題発生個所の特定や切り分けをする場合にも使用できます。

UAPトレース情報の出力ファイル名,および指定できるオプションとその指定方法については,「2.9.1 トレースファイル」を参照してください。

UAPトレースファイルの出力形式を次に示します。

[図データ]

yyyy:UAPトレース取得年
mm:UAPトレース取得月
dd:UAPトレース取得日
hh:mm:ss.uuu:UAPトレース取得時間
lll:UAPトレース取得場所
入り口の場合は「In」,出口の場合は「Out」が出力されます。
ttt:UAPトレースを取得したスレッドの情報
次の形式で取得されます。
プロセス名[プロセスID],スレッド名[スレッドID]
nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn:呼び出したメソッドの名前
eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee:発生した例外
メソッドの入り口で取得されるトレースの場合,または例外が発生しなかった場合は出力されません。
xxxxxxxxxxxxxxxxxxxxxxxxxx:TP1/Serverに伝播する性能検証用の識別情報
iii:メソッドの呼び出し情報

各メソッドの呼び出し情報を,以降の表に示します。

表2-10 AcceptNotificationメソッドの呼び出し情報

取得場所項目文字列内容
入り口サーバからの通知メッセージを格納する領域の長さinf_leninf_len引数で指定したサーバからの通知メッセージを格納する領域の長さ
サーバからの通知メッセージを受信するポート番号portport引数で指定したサーバからの通知メッセージを受信するポート番号
タイムアウト値timeouttimeout引数で指定したタイムアウト値
出口サーバからの通知メッセージinfinf引数に格納したサーバからの通知メッセージ
サーバからの通知メッセージの長さinf_leninf_len引数に格納したサーバからの通知メッセージの長さ
サーバのホスト名hostnamehostname引数に格納したサーバのホスト名
サーバのノード識別子nodeidnodeid引数に格納したサーバのノード識別子

表2-11 AcceptNotificationChainedメソッドの呼び出し情報

取得場所項目文字列内容
入り口サーバからの通知メッセージを格納する領域の長さinf_leninf_len引数で指定したサーバからの通知メッセージを格納する領域の長さ
タイムアウト値timeouttimeout引数で指定したタイムアウト値
出口サーバからの通知メッセージinfinf引数に格納したサーバからの通知メッセージ
サーバからの通知メッセージの長さinf_leninf_len引数に格納したサーバからの通知メッセージの長さ
サーバのホスト名hostnamehostname引数に格納したサーバのホスト名
サーバのノード識別子nodeidnodeid引数に格納したサーバのノード識別子

表2-12 Beginメソッドの呼び出し情報

取得場所項目文字列内容
入り口トランザクションブランチ限界経過時間expireTimeClient .NET構成定義の<transaction>要素のexpireTime属性で指定した値。
値を指定していない場合,-1が設定されます。
トランザクションブランチCPU監視時間cpuTimeClient .NET構成定義の<transaction>要素のcpuTime属性で指定した値。
値を指定していない場合,-1が設定されます。
トランザクションブランチの監視時間の対象expireSuspendClient .NET構成定義の<transaction>要素のexpireSuspend属性で指定した値。
値を指定していない場合,0が設定されます。
  • all:89
  • async:78
  • none:70
統計情報取得項目statisticsClient .NET構成定義の<transaction>要素のstatistics属性で指定した値。
値を指定していない場合,-1が設定されます。
  • base:0x80000000
  • executiontime:0x40000000
  • cputime:0x20000000
  • nothing:0
トランザクション最適化項目optimizeClient .NET構成定義の<transaction>要素のoptimize属性で指定した値。
値を指定していない場合,-1が設定されます。
  • base:0x00000003
  • asyncprepare:0x00000004
トランザクション同期点処理時の最大通信待ち時間internalWatchTimeClient .NET構成定義の<transaction>要素のinternalWatchTime属性で指定した値。
値を指定していない場合,-1が設定されます。
ロールバック情報取得の値rollbackInfoClient .NET構成定義の<transaction>要素のrollbackInfo属性で指定した値。
値を指定していない場合,-1が設定されます。
  • no:0
  • self:0x00000001
  • remote:0x00000002
  • all:0x00000003
トランザクションブランチ最大実行可能時間の値limitTimeClient .NET構成定義の<transaction>要素のlimitTime属性で指定した値。
値を指定していない場合,-1が設定されます。
ロールバック完了通知の値rollbackResponseClient .NET構成定義の<transaction>要素のrollbackResponse属性で指定した値。
値を指定していない場合,-1が設定されます。
  • true
  • false
UAP障害時の同期点処理方式の値recoveryTypeClient .NET構成定義の<transaction>要素のrecoveryType属性で指定した値。
値を指定していない場合,-1が設定されます。
  • type1:0x00000001
  • type2:0x00000002
  • type3:0x00000004
出口性能検証用トレースの識別情報PrfInfo性能検証用トレースの識別情報

表2-13 Callメソッドの呼び出し情報

取得場所項目文字列内容
入り口サービスグループ名group呼び出すサービスのサービスグループ名
サービス名service呼び出すサービス名
送信データ長in_len送信するデータの長さ
送信データin_data送信するデータ
受信データ長out_len受信するデータの長さ
オプションフラグflagsCallメソッドのflagsパラメタに指定した値。
次のどれかの値が設定されます。
  • DCNOFLAGS:0x00000000
  • DCRPC_NOREPLY:0x00000001
  • DCRPC_CHAINED:0x00000004
トランザクション中は次のフラグが設定される場合があります。
  • DCRPC_TPNOTRAN:0x00000020
最大応答待ち時間watchTimeSetRpcWatchTimeメソッドで指定された最大応答待ち時間
rapサーバ通信遅延時間delaySetRapDelayメソッドで指定されたrapサーバ通信遅延時間
出口受信データ長out_len受信した応答の長さ
受信データout_data受信したデータ
性能検証用トレースの識別情報PrfInfo性能検証用トレースの識別情報
注※
非応答型サービス要求の場合,出口情報は性能検証用トレースの識別情報だけです。

表2-14 CallToメソッドの呼び出し情報

取得場所項目文字列内容
入り口接続先ホスト名ConnectionHostDCRpcBindTblクラスで指定されたホスト名
接続先ポート番号ConnectionPortDCRpcBindTblクラスで指定されたポート番号
通信プロトコルフラグProtocolCallToメソッドの通信プロトコルフラグ
  • DCRPC_SCDPORT:0x00000002
サービスグループ名group呼び出すサービスのサービスグループ名
サービス名service呼び出すサービス名
送信データ長in_len送信するデータの長さ
送信データin_data送信するデータ
受信データ長out_len受信するデータの長さ
オプションフラグflagsCallToメソッドのflagsパラメタに指定した値。
次のどちらかの値が設定されます。
  • DCNOFLAGS:0x00000000
  • DCRPC_NOREPLY:0x00000001
最大応答待ち時間watchTimeSetRpcWatchTimeメソッドで指定された最大応答待ち時間
rapサーバ通信遅延時間delaySetRapDelayメソッドで指定されたrapサーバ通信遅延時間
出口受信データ長out_len受信した応答の長さ
受信データout_data受信したデータ
性能検証用トレースの識別情報PrfInfo性能検証用トレースの識別情報
注※
非応答型サービス要求の場合,出口情報は性能検証用トレースの識別情報だけです。

表2-15 CancelNotificationメソッドの呼び出し情報

取得場所項目文字列内容
入り口CUP.NETに通知するメッセージinfinf引数で指定したCUP.NETに通知するメッセージ
CUP.NETに通知するメッセージの長さinf_leninf_len引数で指定したCUP.NETに通知するメッセージの長さ
一方通知受信待ち状態のCUP.NETのホスト名hostnamehostname引数で指定した一方通知受信待ち状態のCUP.NETのホスト名
一方通知受信待ち状態のCUP.NETのポート番号portport引数で指定した一方通知受信待ち状態のCUP.NETのポート番号
出口なし
(凡例)
-:該当しません。

表2-16 CloseConnectionメソッドの呼び出し情報

取得場所項目文字列内容
入り口最大応答待ち時間watchTimeSetRpcWatchTimeメソッドで指定された最大応答待ち時間
出口性能検証用トレースの識別情報PrfInfo性能検証用トレースの識別情報

表2-17 Commitメソッドの呼び出し情報

取得場所項目文字列内容
入り口なし
出口性能検証用トレースの識別情報PrfInfo性能検証用トレースの識別情報
(凡例)
-:該当しません。

表2-18 CommitChainedメソッドの呼び出し情報

取得場所項目文字列内容
入り口なし
出口性能検証用トレースの識別情報PrfInfo性能検証用トレースの識別情報
(凡例)
-:該当しません。

表2-19 GetTransactionIDメソッドの呼び出し情報

取得場所項目文字列内容
入り口なし
出口トランザクショングローバル識別子trngidメソッドが正常終了の場合だけ取得されます。
トランザクションブランチ識別子trnbidメソッドが正常終了の場合だけ取得されます。
(凡例)
-:該当しません。

表2-20 GetTransactionInfoメソッドの呼び出し情報

取得場所項目文字列内容
入り口なし
出口トランザクション中フラグisTransaction
  • トランザクション中である:True
  • トランザクション中ではない:False
(凡例)
-:該当しません。

表2-21 OpenConnectionメソッドの呼び出し情報

取得場所項目文字列内容
入り口接続先ホスト名hosthostパラメタで指定されたrapリスナーまたはファイアウォールのホスト名
接続先ポート番号portportパラメタで指定されたrapリスナーまたはファイアウォールのポート番号
rapサーバ問い合わせ間隔最大時間inquireTimeSetRapInquireTimeメソッドで指定されたrapサーバ問い合わせ間隔最大時間
最大応答待ち時間watchTimeSetRpcWatchTimeメソッドで指定された最大応答待ち時間
出口性能検証用トレースの識別情報PrfInfo性能検証用トレースの識別情報

表2-22 OpenNotificationメソッドの呼び出し情報

取得場所項目文字列内容
入り口サーバからの通知メッセージを受信するポート番号portport引数で指定したサーバからの通知メッセージを受信するポート番号
出口なし
(凡例)
-:該当しません。

表2-23 OpenRpcメソッドの呼び出し情報

取得場所項目文字列内容
入り口プロファイルIDprofileIdprofileIdパラメタで指定された,使用するプロファイルID
出口プロファイルIDprofileIdprofileIdパラメタで指定された,使用するプロファイルID

表2-24 ReceiveAssembledMessageメソッドの呼び出し情報

取得場所項目文字列内容
入り口受信メッセージの最大待ち時間timeout受信メッセージの最大待ち時間
オプションフラグflagsReceiveAssembledMessageメソッドのflagsパラメタで指定した値。
次のどちらかの値が設定されます。
  • DCNOFLAGS:0x00000000
  • DCCLT_RCV_CLOSE:0x00000002
出口受信データ長recvleng受信した応答の長さ
受信データbuff受信したデータ

表2-25 Rollbackメソッドの呼び出し情報

取得場所項目文字列内容
入り口なし
出口性能検証用トレースの識別情報PrfInfo性能検証用トレースの識別情報
(凡例)
-:該当しません。

表2-26 RollbackChainedメソッドの呼び出し情報

取得場所項目文字列内容
入り口なし
出口性能検証用トレースの識別情報PrfInfo性能検証用トレースの識別情報
(凡例)
-:該当しません。

表2-27 SendAssembledMessageメソッドの呼び出し情報

取得場所項目文字列内容
入り口送信データbuff送信するデータ
送信データ長sendleng送信データの長さ
接続先ホスト名hostnamehostnameパラメタで指定した通信相手のホスト名
接続先ポート番号portnumportnumパラメタで指定した通信相手のポート番号
送信メッセージの最大待ち時間timeout送信メッセージの最大待ち時間
オプションフラグflagsSendAssembledMessageメソッドのflagsパラメタで指定した値。
次のどちらかの値が設定されます。
  • DCNOFLAGS:0x00000000
  • DCCLT_SND_CLOSE:0x00000001
出口なし
(凡例)
-:該当しません。

表2-28 SetConnectInformationメソッドの呼び出し情報

取得場所項目文字列内容
入り口DCCM3論理端末の論理端末名infinfパラメタで指定されたDCCM3論理端末の論理端末名
端末識別情報長inf_leninf_lenパラメタで指定された端末識別情報長
出口なし
(凡例)
-:該当しません。

表2-29 SetDataTraceModeメソッドの呼び出し情報

取得場所項目文字列内容
入り口データトレースを出力するディレクトリTrcPathTrcPath引数で指定したデータトレースを出力するディレクトリ
出力するデータトレースファイルのサイズsizesize引数で指定した出力するデータトレースファイルのサイズ
データトレースに出力するデータサイズDataSizeDataSize引数で指定したデータトレースに出力するデータサイズ
データトレースの取得可否フラグflagflag引数で指定したデータトレースの取得可否フラグ
出口なし
(凡例)
-:該当しません。

表2-30 SetErrorTraceModeメソッドの呼び出し情報

取得場所項目文字列内容
入り口エラートレースを出力するディレクトリTrcPathTrcPath引数で指定したエラートレースを出力するディレクトリ
出力するエラートレースファイルのサイズsizesize引数で指定した出力するエラートレースファイルのサイズ
エラートレースの取得可否フラグflagflag引数で指定したエラートレースの取得可否フラグ
出口なし
(凡例)
-:該当しません。

表2-31 SetExtendLevelメソッドの呼び出し情報

取得場所項目文字列内容
入り口拡張機能のレベルflagsClient .NETの機能の拡張レベル
出口なし
(凡例)
-:該当しません。

表2-32 SetMethodTraceModeメソッドの呼び出し情報

取得場所項目文字列内容
入り口メソッドトレースを出力するディレクトリTrcPathTrcPath引数で指定したメソッドトレースを出力するディレクトリ
出力するメソッドトレースファイルのサイズsizesize引数で指定した出力するメソッドトレースファイルのサイズ
メソッドトレースの取得可否フラグflagflag引数で指定したメソッドトレースの取得可否フラグ
出口なし
(凡例)
-:該当しません。

表2-33 SetRapDelayメソッドの呼び出し情報

取得場所項目文字列内容
入り口rapサーバ通信遅延時間secrapサーバ通信遅延時間
出口なし
(凡例)
-:該当しません。

表2-34 SetRapInquireTimeメソッドの呼び出し情報

取得場所項目文字列内容
入り口rapサーバ問い合わせ間隔最大時間secrapサーバ問い合わせ間隔最大時間
出口なし
(凡例)
-:該当しません。

表2-35 SetRpcExtendメソッドの呼び出し情報

取得場所項目文字列内容
入り口拡張機能のレベルextendoptionRPC機能の拡張レベル。
次のどれかの値が設定されます。
  • DCRPC_SCD_LOAD_PRIORITY:0x00000008
  • DCRPC_WATCHTIMINHERIT:0x00000010
  • DCRPC_RAP_AUTOCONNECT:0x00000020
  • DCRPC_WATCHTIMRPCINHERIT:0x00000040
出口なし
(凡例)
-:該当しません。

表2-36 SetRpcWatchTimeメソッドの呼び出し情報

取得場所項目文字列内容
入り口最大応答待ち時間sec最大応答待ち時間
出口なし
(凡例)
-:該当しません。

表2-37 SetTP1Serverメソッドの呼び出し情報

取得場所項目文字列内容
入り口接続先ホスト名hosthostパラメタで指定されたホスト名
接続先ポート番号portportパラメタで指定されたポート番号
出口なし
(凡例)
-:該当しません。

表2-38 SetUapTraceModeメソッドの呼び出し情報

取得場所項目文字列内容
入り口UAPトレースを出力するディレクトリTrcPathTrcPath引数で指定したUAPトレースを出力するディレクトリ
出力するUAPトレースファイルのサイズsizesize引数で指定した出力するUAPトレースファイルのサイズ
UAPトレースの取得可否フラグflagflag引数で指定したUAPトレースの取得可否フラグ
出口なし
(凡例)
-:該当しません。