Implement the J2EE server settings using the Easy Setup definition file.

Define the user-extended trace based performance analysis in the JavaVM startup parameter (add.jvm.arg) in the <configuration> tag of the logical J2EE server (j2ee-server) in the Easy Setup definition file.

The following table describes the definition of the user-extended trace based performance analysis in the Easy Setup definition file.

Table 7-7 Definition of the user-extended trace based performance analysis in the Easy Setup definition file

#1

The default values are as follows:

In Windows

JDK-installation-directory\usrconf\userprf.cfg

In UNIX

/opt/Cosminexus/jdk/usrconf/userprf.cfg

#2

The amount of methods to be traced increases due to the specification format of the user-extended trace based performance analysis configuration file permitted by setting up the jvm.userprf.ExtendedSetting property. Therefore, note that the amount of trace that is output increases and affects the system performance. For details on the notes for using the user-extended trace based performance analysis, see 7.8 Notes for using the user-extended trace based performance analysis.

For details on the Easy Setup definition file and the parameters to be specified, see 4.6 Easy Setup definition file in the uCosminexus Application Server Definition Reference Guide.

An example of definition is as follows:

 ...
<param>
<param-name>add.jvm.arg</param-name>
<param-value>-Djvm.userprf.Enable=true</param-value>
<param-value>-Djvm.userprf.File=Cosminexus-installation-directory/CC/server/usrconf/ejb/real-server-name/userprf.cfg</param-value>
<param-value>-Djvm.userprf.LogLevel=class</param-value>
</param>
 ...

Reference note

You can also specify the J2EE server settings in the Start Parameter Settings window (defining the logical J2EE server) of the management portal. For details on how to specify the settings on the management portal, see 10.9.20 Startup parameter settings (J2EE server) in the uCosminexus Application Server Management Portal Operation Guide.

Implement the batch server settings using the Easy Setup definition file.

Define the user-extended trace based performance analysis in the JavaVM startup parameter (add.jvm.arg) in the <configuration> tag of the logical J2EE server (j2ee-server) in the Easy Setup definition file. For details on the parameter values to be specified, see (1) J2EE server settings.

Implement the settings for an EJB client application, which is running with the cjclstartap command, using the option definition file for EJB client applications (usrconf.cfg).

Define the user-extended trace based performance analysis in the JavaVM startup parameter (add.jvm.arg) of the option definition file for EJB client applications (usrconf.cfg). For details on the parameter values to be specified, see (1) J2EE server settings.

An example of definition in the option definition file for EJB client applications (usrconf.cfg) is as follows:

 ...
add.jvm.arg= -Djvm.userprf.Enable=true
add.jvm.arg= -Djvm.userprf.File=Cosminexus-installation-directory/CC/server/usrconf/ejb/real-server-name/userprf.cfg
add.jvm.arg= -Djvm.userprf.LogLevel=class
 ...

To use the user-extended trace based performance analysis, you must create the configuration file for the user-extended trace based performance analysis and specify the settings for the methods to be traced.

Specify the settings for the methods to be traced in the UserPrfText parameter in the <configuration> tag of the logical J2EE server (J2EE-Server) in the Easy Setup definition file.

An example of definition is as follows:

 ...
<param>
<param-name>UserPrfText</param-name>
<param-value>
<![CDATA[
org.apache.struts.action.Action.execute(*), struts, true
Info.getInfo(*), struts, true
]]>
</param-value>
</param>
 ...

For details on how to create the configuration file for the user-extended trace based performance analysis, see 7.5.3 Settings for the methods to be traced by the user-extended trace based performance analysis.

Reference note

You can also set up the configuration file for the user-extended trace based performance analysis in the Start Parameter Settings window (defining the logical J2EE server) of the management portal or a user optional file (file specified in the jvm.userprf.File property).