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

8.1.3 Debugging with the API Snapshot Function

The API snapshot function logs a variety of I/O information relating to Java APIs or C APIs.

The following information can be read from this log and used for debugging purposes when developing applications that use Java APIs, .NET APIs or C APIs:

• Method or function invocation sequences
• Return information, parameter information and any exception or error information relating to methods or functions.
• Method or function execution times.
• The request number that is output in the performance log (The 8-bytes number from the conductor)

Information Output by the API Snapshot Function

The following table shows the information that is output by the API snapshot function.

[Table 8-1 Information Output by the API Snapshot Function]

Type	Content
Various Java API I/O information	Outputs the following information relating to a Java API that has been invoked by an application: (*1) Information relating to when the method was invoked Information relating to when the method was returned Information relating to when an exception occurred in the method Detailed information about the output content and format, and output examples, etc., can be found in 8.1.4 Java API Method Information.
Various .NET API I/O information	Outputs the following information relating to a .NET API that has been invoked by an application: Information relating to when the method was invoked Information relating to when the method was returned Information relating to when an exception occurred in the method Detailed information about the output content and format, and output examples, etc., can be found in 8.1.5 .NET API Method Information.
Various C API I/O information	Outputs the following information relating to a C API function that has been invoked by an application: Information relating to when the function was invoked Information relating to when the function was returned Information relating to when an error occurred in the function Detailed information about the output content and format, and output examples, etc., can be found in 8.1.6 C API Function Information.

*1) The various I/O information of ShunException class will not be output.

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

Environment Settings of the API Snapshot Function

To output an API snapshot, set the following execution parameters in the API environment file:

• SnapLevel
• LogFile
• LogFileSize
• LogFileBackup
• PfmLog

Refer to 2.4 Setting Up Environment Files or Appendix A Execution Parameters in API Environment Files for more information on the API environment file.