3.2.1 usrconf.cfg (Option definition file for batch servers)

(1) Format

Specify the key as follows:

key-name=value

How to specify:

• The string up to the linefeed is a value.

• The line beginning with a hash mark (#) is a comment.

• If you define a line without a value, the line is ignored.

• You cannot add alphanumeric strings such as spaces and comments after the value. If you add such values, they will be considered as invalid.

(Example) key-name=value#comment

• You cannot code with a character encoding that is different from the runtime character encoding.

To Page Top

(2) File storage location

• In Windows

  Cosminexus-installation-directory\CC\server\usrconf\ejb\server-name\

• In UNIX

  /opt/Cosminexus/CC/server/usrconf/ejb/server-name/

To Page Top

(3) Functionality

Specify the invocation options of the JavaVM that execute the batch servers.

If you change the contents of this file while the batch server is running, the changes become effective only when the batch server is started next.

To Page Top

(4) Specifiable keys

The following table describes the specifiable keys and the default values. For details about keys, see 2.2.2 usrconf.cfg (Option definition file for J2EE servers). Furthermore, when referencing, substitute J2EE server and J2EE application for Batch server and Batch application respectively.

Important note

If you use multibyte characters within the files, integrate the multibyte characters and encode used in the following locations:

• usrconf.cfg (option definition file for batch applications)

• Arguments of the cjexecjob command (batch application execution command)

• Source code of the batch application (java.lang.System.out or java.lang.System.err)

Table 3‒2: Specifiable keys and default values in usrconf.cfg (batch servers)

Key name	Overview	Default value
add.jvm.arg	This key invokes JavaVM by using the specified option. For details about the Java VM options that can be specified by using add.jvm.arg keys, see 14.1 List of JavaVM extension options and 14.5 Java HotSpot VM options that can be specified in Cosminexus.	For details about default values, see 3.2.1(5) Default values of JavaVM options for batch servers.
add.class.path	Specify the class path for a container extension library. When you specify a path containing a space, you do not need to enclose the path in double quotation marks ("). Also, the path specified in double quotation marks is invalid. To add a JAR file in the class path of a batch application class loader, specify the add.class.path key in the option definition file for batch applications.	None
add.library.path#	Specify the shared library for JNI only when the container extension library uses JNI.	None
batch.service.enabled	Do not edit this key manually. When the batch option is specified in the cjsetup command and executed, true is displayed in the key value.	true (when -batch option is specified in -cjsetup command, and executed)
cpp.library.version	Specify the libstdc++ library version to be used in a process. Note that this key is used for Linux. The specifiable string is as follows: 6: Use the libstdc++.so.6 library. This key is disabled even if set up on platforms other than Red Hat Enterprise Linux. With version 09-00 or later, only 6 can be set up.	6
ejb.public.directory	Start a batch server using the specified directory as the working directory of batch server.	In Windows Cosminexus-installation-directory\CC\server\public In UNIX /opt/Cosminexus/CC/server/public
ejb.server.corefilenum (in UNIX)	Specify the number of core files that remain when restarting a batch server.	1
ejb.server.log.directory	Specify the output location directory of the log file. Make sure that the specified log data output-destination directory is not shared with Cosminexus Manager, J2EE servers, or Web container servers (compatibility functionality). If the directory is shared, operations are not guaranteed.	In Windows Cosminexus-working-directory\ejb\server-name\logs In UNIX Cosminexus-working-directory/ejb/server-name/logs
ejb.server.log.mode	Specify the output format of the log file.	7
ejb.server.log.stdout.filesize	Specify the upper-limit for the size of the cjstdout.log file.	1048576
ejb.server.log.stderr.filesize	Specify the upper-limit for the size of the cjstderr.log file.	1048576
jvm.type	Specify the type of JavaVM to be used.	server

To Page Top

(5) Default values of JavaVM options for batch servers

The following are the default values of Java VM options for batch servers:

• -Xms256m

• -Xmx512m

• -XX:MetaspaceSize=128m

• -XX:MaxMetaspaceSize=128m

• -XX:+HitachiOutOfMemoryStackTrace

• -XX:SurvivorRatio=8

• -XX:HitachiJavaLog:<ejb.server.log.directory>

• -XX:HitachiJavaLogFileSize=4m

• -XX:-HitachiUseExplicitMemory

• -XX:+HitachiVerboseGC

• -XX:+HitachiVerboseGCPrintCause

• -XX:+HitachiOutputMilliTime

• -XX:-HitachiThreadDumpToStdout

• -XX:+HitachiOutOfMemoryAbort

• -XX:+HitachiJavaClassLibTrace

• -XX:HitachiJavaClassLibTraceLineSize=1024

• -XX:+HitachiLocalsSimpleFormat

• -XX:+HitachiTrueTypeInLocals

• -XX:+HitachiLocalsInStackTrace

• -XX:+HitachiUseExplicitMemory

• -XX:HitachiExplicitHeapMaxSize=64m

• -XX:HitachiExplicitMemoryLogLevel:normal

• -XX:HitachiExplicitMemoryJavaLog:<ejb.server.log.directory>

• -XX:HitachiExplicitMemoryJavaLogFileSize=4m

To Page Top

(6) Notes

• Among the values specified in the add.class.path key, there are some values for which the <cosminexus.home> tag is used to specify the JAR files for the container extension library. These values indicate the installation destination of Application Server, so you do not need to change the contents coded for the add.class.path key. Note that when you add the container extension library to the add.class.path key, the installation and uninstallation operations might not be guaranteed. Therefore do not use the <cosminexus.home> tag.

• For the add.jvm.arg key, do not specify the --add-modules or --module-path option. If you do so, operations are not guaranteed.

To Page Top