L.6 User log functionality sample program

(a) Setting the J2EE server

See Appendix L.1(1) Setting the J2EE server.

(b) Compiling the sample file

Compile the user log samples with the batch file (compile.bat) provided in the sample.

On compiling, "myloglib.jar" file is created. Store this file in any directory to allow access to the JAR file. For details on allowing the access to the file, see 8.7.2 Using container extension library in the uCosminexus Application Server Expansion Guide.

(c) Setting the property information

The property information is set in the set up server. Some contents in usrconf.properties of the set up server are rewritten in the set up file (sample.properties) provided in the sample. For building a system using Management Server, see 8.8 Setting the user log output of J2EE applications in the uCosminexus Application Server Expansion Guide.

The storage location of usrconf.properties and the rewritten portion in usrconf.properties file, when the set up server is "MyServer" are as follows:

• File location

  Cosminexus-installation-directory\CC\server\usrconf\ejb\MyServer\usrconf.properties

• Rewritten portion in the file:

  The following part is rewritten with the contents of sample.property.

     :
  # user-log handler settings
  #ejbserver.application.userlog.CJLogHandler.<Specify handler-name>.path=user_log
  #ejbserver.application.userlog.CJLogHandler.<Specify handler-name>.count=2
     :
  # user-log logger settings
  #ejbserver.application.userlog.Logger.<Specify logger-name>.handlers=<Specify handler-class>
  #ejbserver.application.userlog.Logger.<Specify logger-name>.useParentHandlers=true
     :

The contents of sample.properties provided in the sample are as follows:

# user-log handler settings
#conf1 settings
ejbserver.application.userlog.CJLogHandler.conf1.path=userlog/logFileA
ejbserver.application.userlog.CJLogHandler.conf1.level=ALL
ejbserver.application.userlog.CJLogHandler.conf1.appname=userlog_app
ejbserver.application.userlog.CJLogHandler.conf1.formatter=com.hitachi.software.ejb.application.userlog.CJSimpleFormatter
 
#conf2 settings
ejbserver.application.userlog.CJLogHandler.conf2.path=userlog/logFileB
ejbserver.application.userlog.CJLogHandler.conf2.level=SEVERE
ejbserver.application.userlog.CJLogHandler.conf2.appname=userlog_app
 
#conf3 settings
ejbserver.application.userlog.CJLogHandler.conf3.path=userlog/logFileC
ejbserver.application.userlog.CJLogHandler.conf3.level=INFO
ejbserver.application.userlog.CJLogHandler.conf3.appname=userlog_app
 
# user-log logger settings
#logger1 settings
ejbserver.application.userlog.Logger.com.example.userlogger1.handlers=com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf1,com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf2
ejbserver.application.userlog.Logger.com.example.userlogger1.level=ALL
 
#logger2 settings
ejbserver.application.userlog.Logger.com.example.userlogger2.handlers=com.hitachi.software.ejb.application.userlog.CJMessageFileHandler;conf3
ejbserver.application.userlog.Logger.com.example.userlogger2.level=INFO
 
ejbserver.application.userlog.loggers=com.example.userlogger1, com.example.userlogger2

For the setting of NIO HTTP server, see Appendix L.1(2) Customizing the J2EE server.

(d) Starting the J2EE server

See Appendix L.1(3) Starting the J2EE server.

(e) Deploying the application

See Appendix L.1(5) Importing, setting and starting the application.

(f) Executing the application

Start the browser and specify the following string in the URL:

http://Machine-name :Port-number/ContextRoot/userlog.html

When accessing the NIO HTTP server of the J2EE server directly, specify the URL as follows if using the default port:

http://localhost:8008/userlog/userlog_war/userlog.html

(g) Execution example of userlog

The following example shows the method of executing the userlog. The following figure shows the Select the Execution Sample Type window displayed on executing the application and specifying the URL.

Select the type of sample to be executed and move to each data input form. The following example describes the subsequent operations on the window and method to output the log for each selected type.

When the name of the set up server is "MyServer", the resulting log file is output to the following directory by the file name set in usrconf.properties.

Cosminexus-installation-directory\CC\server\public\MyServer\logs\user\userlog

• Type 1: Execution example of the message output

  The following example shows the window transition and output of log file when you select Sample for outputting message from the servlet type on the Select the Execution Sample Type window.

  After selecting the type, enter the following values in the displayed Input window:

  • Logger name: com.example.userlogger1

  • Message: AAA

  • Message level: SEVERE (fatal)

  The following figure shows the Input window when you select Type 1:

  Figure L‒36: Input window (Type 1: User log sample program)

  The following figure shows the Display Input Result window on clicking the send button after input:

  Figure L‒37: Display Input Result window (Type 1: User log sample program)

  In this example, the result is output to logfileA and logfileB.

  The output result of logfileA is as follows:

  0310 2005/01/21 20:37:53.296   userlog_app   00922804 01000BCF Msg_100        2005/01/21 20:37:53|UserLogServlet|doPost|fatal|AAA

  The output result of logfileB is as follows:

  0888 2005/01/21 19:41:03.609   userlog_app   00922804 009B6220 Msg_100        AAA

• Type 2: Execution example of the output of entered numbers and total value

  The following example shows the window transition and output of log file when you select Sample for outputting the entered numbers and total value from AdderEJB type on the Select the Execution Sample Type window.

  After selecting the type, enter the following values in the displayed Input window:

  • Logger name: com.example.userlogger1

  • Input number: 10

  The following figure shows the Input window when you select Type 2:

  Figure L‒38: Input window (Type 2: User log sample program)

  The following figure shows the Display Input Result window on clicking the send button after input:

  Figure L‒39: Display Input Result window (Type 2: User log sample program)

  In this example, the result is output only to logfileA.

  The output result of logfileA is as follows:

  0324 2005/01/21 20:38:59.500   userlog_app   00922804 015C998A Adder_200       2005/01/21 20:38:59|AdderEJB|add|information|inputNumber = 10
  0327 2005/01/21 20:38:59.500   userlog_app   00922804 015C998A Adder_201       2005/01/21 20:38:59|AdderEJB|getTotal|information|total = 10

• Type 3:Execution example of exception logs output

  The following example shows the window transition and output of log file when you select Sample for outputting exception logs from the servlet type on the Select the Execution Sample Type window.

  After selecting the type, enter the following value in the displayed Input window:

  • Logger name: com.example.userlogger2

  The following figure shows the Input window when you select Type 3:

  Figure L‒40: Input window (Type 3: User log sample program)

  The following figure shows the Display Input Result window on clicking the send button after input:

  Figure L‒41: Display Input Result window (Type 3: User log sample program)

  In this example, the result is output only to logfileC.

  The output result of logfileC is as follows:

  1077 2005/01/21 19:55:19.328   userlog_app   00922804 006458A6 Exp_300        message:Exception   LEVEL:SEVERE

(h) Undeploying the application

See Appendix L.1(6) Stopping and deleting the application.

(i) Stopping the J2EE server

See Appendix L.1(7) Stopping the J2EE server.