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

8.1.4 Java 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

Package name, connection ID, thread name, date, time, Call, class name, method name

When a Method Returns

Package name, connection ID, thread name, date, time, Return, class name, method name, method execution time, Performance Information

When an Error is Returned

Package name, connection 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

Package name, connection ID, thread name, date, time, Call, class name, method name, parameter information

When a Method Returns

Package name, connection ID, thread name, date, time, Return, class name, method name, method execution time, return value information, Performance Information

When an Error is Returned

Package name, connection ID, thread name, date, time, Throw, class name, method name, method execution time, exception class name: Exception details string, Perofrmance Information

Output Content

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

[Table 8-2 Content of the Java API Method Information Output]

Output item	Content	Output level
		Level 1	Level 2
Package name	Displays the package name of the application that invoked the API.
Connection ID	Outputs the identifier of the connection 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 Java API class that was invoked.
Method name	Outputs the name of the Java API method that was invoked.
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 Java API is operating.

Output examples for the different output levels are shown below.

Level 1

Normal Termination

"JavaAPISample2",2951274,"main","2006/10/22","10:06:53.975","Call","ShunConnection","ShunConnection"
"JavaAPISample2",2951274,"main","2006/10/22","10:06:54.385","Return","ShunConnection","ShunConnection",0.41,,"42d234c100000100"

Abnormal Termination

"JavaAPISample2",2951274,"main","2006/10/22","14:55:07.001","Call","ShunConnection","ShunConnection"
"JavaAPISample2",2951274,"main","2006/10/22","14:55:09.144","Throw","ShunConnection","ShunConnection",2.143, 
"com.fujitsu.shun.common.ShunException: shn30606u:Either the director or the conductorhas not been started, or the port number is incorrect. 
at com.fujitsu.shun.core.AccessStreamBasic.connect(AccessStreamBasic.java:181)
 at com.fujitsu.shun.core.AccessStream.connect(AccessStream.java:133)
 at com.fujitsu.shun.core.AccessStream.<init>(AccessStream.java:124)
 at com.fujitsu.shun.ShunConnection.openConnection(ShunConnection.java:1600)
 at com.fujitsu.shun.ShunConnection.<init>(ShunConnection.java:391)
 at JavaAPISample2.main(JavaAPISample2.java:33)
",

Level 2

Normal Termination

"JavaAPISample2",2951274,"main","2006/10/22","10:07:55.103","Call","ShunConnection","ShunConnection",,"(String)localhost,(int)10007,(String)file1"
"JavaAPISample2",2951274,"main","2006/10/22","10:07:55.523","Return","ShunConnection","ShunConnection",0.42,"","42d234c100000100"

Abnormal Termination

"JavaAPISample2",2951274,"main","2006/10/22","14:55:07.001","Call","ShunConnection","ShunConnection",,"
(String)localhost,(int)10007,(String)file1"

"JavaAPISample2",2951274,"main","2006/10/22","14:55:09.144","Throw","ShunConnection","ShunConnection",2.143,
"com.fujitsu.shun.common.ShunException: shn30606u:Either the director or the conductor has not been started, or the port number is incorrect.
at com.fujitsu.shun.core.AccessStreamBasic.connect(AccessStreamBasic.java:181)
 at com.fujitsu.shun.core.AccessStream.connect(AccessStream.java:133)
 at com.fujitsu.shun.core.AccessStream.<init>(AccessStream.java:124)
 at com.fujitsu.shun.ShunConnection.openConnection(ShunConnection.java:1600)
 at com.fujitsu.shun.ShunConnection.<init>(ShunConnection.java:391)
 at JavaAPISample2.main(JavaAPISample2.java:33)
",

• 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 log file with the connection identifier.