Of the information output in the stack trace, the contents extended by JavaVM are described here.

When an error occurs in a server and applications, you can investigate the cause for error occurrence by confirming the stack trace contents until the error occurred.

The stack trace is output at either of the following timings:

• When an exception occurs in the J2EE servers or J2EE applications
• When an exception occurs in batch servers or batch applications
• When JavaVM thread dump is output

In JavaVM, you can output the information of local variables in Java methods in the stack trace by specifying start options when starting the server. The information of local variables defined in Java methods is effective for analyzing the cause of errors when exceptions occur.

Note that, the Local variables referenced here are the objects (this) that are passed to the methods as arguments and are invoked by instance methods. In the local variable information, these local variable names, type names, and local variable values are output. Note that the type name is the basic type name, class name (including interface name), or array type name.

The following table describes the options to output the local variable information to stack trace. For details on settings for acquiring the JavaVM material, see the subsection 3.3.19 Settings for Acquiring the JavaVM Material.

Table 5-29 Options to output the local variable information to stack trace

Startup options	Timing to output stack trace	Option that can be specified simultaneously
-XX:+HitachiLocalsInThrowable	When an exception occurred in servers or applications#	-XX:MaxJavaStackTraceDepth= Maximum-depth -XX:+HitachiLocalsSimpleFormat -XX:+HitachiTrueTypeInLocals -XX:HitachiCallToString=applicable-range
-XX:+HitachiLocalsInStackTrace	When JavaVM thread dump is output	-XX:MaxJavaStackTraceDepth= Maximum-depth -XX:+HitachiLocalsSimpleFormat -XX:+HitachiTrueTypeInLocals

#

However, when the exception occurred is java.lang.StackOverflowError or java.lang.OutOfMemoryError, the local variables are not output to stack trace.

The contents output is described with an example as base when you specify each of these options. For details on the items output when each option is specified, see the following points in the uCosminexus Application Server Definition Reference Guide:

• -XX:[+|-]HitachiLocalsInThrowable (Option for collecting the local variable information when exception is thrown)
• -XX:[+|-]HitachiLocalsInStackTrace (Option for collecting the local variable information when thread dump is output)

Organization of this section

5.10.1 When the -XX:+HitachiLocalsInThrowable Option Is Specified

5.10.2 When the -XX:+HitachiLocalsInStackTrace Option Is Specified