uCosminexus Application Server, Messages

[Contents][Back][Next]

24.4 Messages output in the development check log

When you develop applications using the following functionality, valid messages are output during the development process. The log in which these messages are output is called the development check log.

No prefixes and IDs are output in these messages. Also, these messages are not output by default. Specify the settings to output the messages as and when required and then develop the applications.

This section describes the output destination, output format, level, and settings for the development check log.

Organization of this section
(1) Output destination of the development check log
(2) Output format
(3) Log levels
(4) Settings for number, size, and level of log files

(1) Output destination of the development check log

The development check log is output to a file generated on the console or at the following path:

Log-output-directory-for-J2EE-servers-(ejb.server.log.directory)\cjdevelopment[n].log

n indicates the number of log files. The settings for the number of files n are described in 24.4(4)Settings for number, size, and level of log files.

(2) Output format

The development check log messages are output in the following format:

Number Date Time AP name Pid tid Space Message text CRLF

The following information is output in the "message text":

Furthermore, the message text is output in two separate rows as follows:

1st row Log level Name of the class that outputs the message Name of the method that outputs the message
2nd row Message details
Note
If stack trace is output, the trace is output from the 2nd row onwards (if no message is specified), or from the 3rd row onwards.
For details on the contents output apart from the message text, see 5.2.1 Format of output and items output to Hitachi Trace Common Library log in the manual uCosminexus Application Server Maintenance and Migration Guide.

(3) Log levels

The development check log can be output in the following nine levels. From item no. 2 to 8, higher the item no., more detailed is the information that is output.

Table 24-1 Log levels provided for the development check log

Item no. Level Remarks#
1 ALL All the messages are output to the log
2 SEVERE Important level messages, such as messages for fatal errors, are output to the log
3 WARNING Warning level messages are output to the log
4 INFO Information level messages are output to the log
5 CONFIG Static level messages are output to the log
6 FINE Debug level log is output (trace level information)
7 FINER Debug level log is output
8 FINEST Debug level log is output (Most detailed level)
9 OFF No message is output
Default level

#

(4) Settings for number, size, and level of log files

You specify the settings for the number, size, and level of development check log files in the <configuration> tag of the logical J2EE server (j2ee-Server) in the Easy Setup definition file.

The following table lists and describes the keys that can be used to set up the number, size, and level of log files.

Table 24-2 Details of keys that can be used to set up the number, size, and level of development check log files

Item Key name Contents Default value Unit
Number of files ejbserver.logger.channels.define.DevelopmentLogFile.filenum Specifies the number of log files output with the development check log functionality. 4 Number of files
File size ejbserver.logger.channels.define.DevelopmentLogFile.filesize Specifies the size of the log files output with the development check log functionality. 1048576 byte
Log output level ejbserver.logger.DevelopmentLogFile.level Specifies the log output level of the development check log functionality. OFF --

Legend:
--: Not applicable

Note "Default value" is the value that is assumed when no key is specified.

Hint
Specifying the log level
To troubleshoot the application being developed, we recommend that you first set the INFO level. If the information output at the INFO level is inadequate for investigation, specify the CONFIG or FINE levels that output more detailed log. If you require further details, specify the FINER level.
You, thus, specify levels that output details in a graded manner, as and when required, and obtain detailed information.

The following is an example of using the Easy Setup definition file to set up the number, size, and level of development check log files:

:
 <logical-server-name>j2ee-server</logical-server-name>
 <configuration>
  <param>
  <param-name>
   ejbserver.logger.channels.define.DevelopmentLogFile.filenum
  </param-name>
  <param-value>4</param-value>
  </param>
  <param>
  <param-name>
   ejbserver.logger.channels.define.DevelopmentLogFile.filesize
  </param-name>
  <param-value>1048576</param-value>
  </param>
  <param>
  <param-name>
   ejbserver.logger.DevelopmentLogFile.level
  </param-name>
  <param-value>OFF</param-value>
  </param>
 </configuration>
:

For details on the parameters and the Easy Setup definition file, see 2.4 usrconf.properties (User property file for J2EE servers) and 4.6 Easy Setup definition file in the manual uCosminexus Application Server Definition Reference Guide.