Interstage Shunsaku Data Manager Application Development Guide - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX -

8.1.5 .NET API Method Information

Information about a method invoked from an application is output when the method is invoked by an application, when the method returns, and when an exception occurs.

Output Format

The API snapshot is output in CSV format.

The output format for each output level is shown below.

Level 1

When a Method is Invoked

Program name, service ID, thread name, date, time, Call, class name, method name

When a Method Returns

Program name, service ID, thread name, date, time, Return, class name, method name, method execution time, Performance Information

When an Error is Returned

Program name, service ID, thread name, date, time, Throw, class name, method name, method execution time, exception class name: Exception details string, Performance Information

Level 2

When a Method is Invoked

Program name,service ID,thread name,date,time,Call,class name,method name,,parameter information

When a Method Returns

Program name, service ID, thread name, date, time,Return, class name, method name, method execution time, return value information, Performance Information

When an Error is Returned

Program name, service ID, thread name, date, time,Throw, class name, method name, method execution time, exception class name : Exception details string, Performance Information

Output Content

The following table lists the items that are output and their content.

[Table 8-3 Content of the .NET API Method Information Output]

Output item	Content	Output level
		Level 1	Level 2
Program name	Displays the program name of the application that invoked the API.
Service ID	Outputs the identifier of the ShunService object.
Thread name	Outputs the thread name.
Date	Outputs the method invocation start/end date in the format "yyyy/mm/dd".
Time	Outputs the method invocation start/end time in the format "hh:mm:ss.ms".
Call Return Throw	"Call": Indicates that the information relates to when a method was invoked. "Return": Indicates that the information relates to when a method was returned. "Throw": Indicates that an exception occurred in the method.
Class name	Outputs the name of the .NET API class that was invoked.
Method name	Outputs the name of the .NET API method that was invoked. Outputs the properties names when obtaining or setting the properties.
Method execution time	Outputs the period (in seconds) between the time that a method is invoked and the time that the method returns.
Parameter information	Outputs parameter information (parameter type and value) in the following format when a method is invoked: (Parameter type) Value or (Parameter type)<Object> If there are no parameters, this item will not be displayed.	x
Return value information	Outputs method return value information (return value type and value) in the following format: (Return value type) Value or (Return value type)<Object> This item will not be output if the return value is void.	x
Exception class name	Outputs the exception class name if an exception occurs when a method is invoked. If the exception contains a details string, that details string will also be output.
Performance Information	Outputs the number that is output in the performance log (The 8-bytes number from the conductor (*1)

:Item is output
x :Item is not output

*1) Refer to Output Information of Performance Log in the Operator's Guide for more information on the output of performance log.

Output Examples

The information that is output to a snapshot is output in the character code of the platform where the .NET API is operating.

Output examples for the different output levels are shown below.

Level 1

Normal Termination

"sample.exe",2,"(3964)","2006/04/19","21:32:35.151","Call","ShunService","GetHitCount",,,
"sample.exe",2,"(3964)","2006/04/19","21:32:35.198","Return","ShunService","GetHitCount",0.046875,,"44462b7f00000002"

Abnormal Termination

"sample.exe",2,"(3964)","2006/04/19","21:32:35.198","Call","ShunService","GetHitCount",,,
"sample.exe",2,"(3964)","2006/04/19","21:32:35.214","Throw","ShunService","GetHitCount",0.015625,"InvalidOperationException: 
shn30910u:Connection has not been connected.",

Level 2

Normal Termination

"sample.exe",2,"(3436)","2006/04/19","21:33:37.417","Call","ShunService","GetHitCount",,"(String) /document/base/prefecture == 'Sydney' ",
"sample.exe",2,"(3436)","2006/04/19","21:33:37.448","Return","ShunService","GetHitCount",0.03125,"(Int32) 5 ","44462b7f00000004"

Abnormal Termination

"sample.exe",2,"(3436)","2006/04/19","21:33:37.448","Call","ShunService","GetHitCount",,"(String) /document/base/prefecture == 'Sydney' ",
"sample.exe",2,"(3436)","2006/04/19","21:33:37.464","Throw","ShunService","GetHitCount",0.015625,"InvalidOperationException: 
shn30910u:Connection has not been connected.",

• Enclose character string items in double quotes (").
• Do not enclose numerical values in double quotes (").

The operation of each connection can be traced chronologically by filtering the collected snapshot with the service identifier.