Specify the key as follows:
key-name=value
Specify the invocation options of the JavaVM that execute the J2EE servers.
If you change the contents of this file while the J2EE server is running, the changes become effective only when the J2EE server is started next.
The following table describes the specifiable keys and the default values: VR is the version of Application Server on which parameters are introduced or changed.
Table 2-2 Specifiable keys and default values in usrconf.cfg (J2EE servers)
Key name | Contents | Default | VR |
---|---|---|---|
add.jvm.arg | This key invokes JavaVM by using the specified option. If you want to specify the system properties, do not use the -D option, but specify the properties in the usrconf.properties file. When specifying multiple options, use the same key name and specify multiple times as follows: (Example of specification) add.jvm.arg= -Xms256m add.jvm.arg= -Xmx512m You cannot specify multiple options as shown in the following example. If you specify the options as shown below, the initialization of JavaVM will fail. (Example of specification) add.jvm.arg=-Xms256m -Xmx512m For details about the JavaVM options that you can specify in add.jvm.arg, see 2.3(5)(a) JavaVM options that can be specified in the add.jvm.arg key of the J2EE server. | For details about default values, see 2.3(5)(b) Default values of the JavaVM options in J2EE servers. | -- |
add.class.path | Specify JAR for the container extension library. If a path containing space is specified in the value, the path need not be enclosed with double quotation mark ("). Also, values specified in double quotations are not valid. | None | -- |
add.library.path#1 | Specify the shared library for JNI only when the container extension library uses JNI. | None | -- |
cpp.library.version | Specify the version of libstdc++ library used in the process. Note that this key is used in Linux. The following string can be specified:
This key will be invalid when specified on platforms other than Red Hat Enterprise Linux. | 6 | -- |
ejb.public.directory | Start a J2EE server using the specified directory as the working directory of J2EE server. The current directory of J2EE server is as follows:
|
| -- |
ejb.server.corefilenum (in UNIX) | Specify an integer value from 0 to 16 for the number of core files that remain when a J2EE server is restarted. Note that this key is used for UNIX. Among the following target core files, the specified number of files, starting from the one with the latest creation time, is left behind and all the other files are deleted. Generally, specify 1 as the number of core files output when a J2EE server is down.
When the process of renaming or deleting a core file fails, a message KDJE40047-E is output, the process of starting the J2EE server is cancelled and terminates abnormally. Note the following:
| 1 | -- |
ejb.server.log.directory | Use the specified directory as the output destination of the log file#2. Specify the path length from 1 to 200 bytes. In Windows, you cannot specify a path that includes a UNC name. In UNIX, you cannot specify a path of an nfs-mounted disk. When specifying this key, create a directory to output log before starting the server. If you specify a directory that does not exist, the message KDJE40024-E is output when the J2EE server starts up, and then the server is terminated abnormally. Make sure that you do not specify the same directory as the log output destination directory for another J2EE server or Web container server (compatible functionality). If you specify the same directory, the operation will not produce the desired results. Note that if you specify this key and output the log to a directory other than the working directory, the log files in the change destination directory are not deleted when you uninstall the server. If you want to delete the log files, delete them manually. |
| -- |
ejb.server.log.mode | Specify the output format of the log file. The following strings can be specified:
| 7 | -- |
ejb.server.log.stdout.filesize | Specify an integer from 4096 to 2147483647 (unit: byte) as the upper-limit for the size of the cjstdout.log file. | 1048576 | -- |
ejb.server.log.stderr.filesize | Specify an integer from 4096 to 2147483647 (unit: byte) as the upper-limit for the size of the cjstderr.log file. | 1048576 | -- |
jvm.type | Specify the type of JavaVM to be used. You can specify one of the following values:
| server | -- |
Types of log | Contents | Log collection directory and log file names |
---|---|---|
Message log | Operation log |
|
Log operation log |
| |
User log | Web servlet log |
|
User output log |
| |
User error log |
| |
JavaVM maintenance information and garbage collection log |
| |
Event log | Event log for the Explicitly Memory Management functionality of JavaVM |
|
Exception log | Exception information in the case of failure |
|
Log for maintenance | Maintenance information |
|
Console messages |
| |
Maintenance information of EJB container |
| |
Maintenance information of Web container |
| |
Standard output information of the invocation process |
| |
Backup of standard output information of the invocation process |
| |
Standard error information of the invocation process |
| |
Backup of standard error information of the invocation process |
| |
Termination process information |
| |
Maintenance log of resource adapter | -- |
|
TPBroker trace | Trace information of TPBroker |
|
This section describes the JavaVM options that you can specify in add.jvm.arg and the default values for J2EE servers.
This section describes the JavaVM options that you can specify in the add.jvm.arg key of the J2EE server. JavaVM options include the options that can be specified as per the standards and the JavaVM extension options. Also, the default values of JavaVM options depend on the server to be used. For details on the JavaVM extension options, see 16.1 List of JavaVM extension options. For details about Java HotSpot VM options, see 16.5 Java HotSpot VM options that can be specified in Cosminexus.
The following are the Java HotSpot VM options that you can specify in add.jvm.arg of the J2EE server:
This section describes the default values of JavaVM options for J2EE servers:
# java vm options
add.jvm.arg=-Xms256m
add.jvm.arg=-Xmx512m
add.jvm.arg=-XX:PermSize=128m
add.jvm.arg=-XX:MaxPermSize=128m
add.jvm.arg=-XX:+HitachiVerboseGC
add.jvm.arg=-XX:HitachiVerboseGCIntervalTime=600
# ejb public directory
ejb.public.directory=c:\workdir
# ejb.server.log.directory
ejb.server.log.directory=c:\logdir\servername
# java vm options
add.jvm.arg=-Xms256m
add.jvm.arg=-Xmx512m
add.jvm.arg=-XX:PermSize=128m
add.jvm.arg=-XX:MaxPermSize=128m
add.jvm.arg=-XX:+HitachiVerboseGC
add.jvm.arg=-XX:HitachiVerboseGCIntervalTime=600
# ejb public directory
ejb.public.directory=/opt/workdir
# ejb.server.log.directory
ejb.server.log.directory=/CClogs/server/servername
# ejb.server.corefilenum
ejb.server.corefilenum=3