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

Organization of this section
(1) Format
(2) File storage location
(3) Functionality
(4) Specifiable keys
(5) JavaVM options that can be specified with add.jvm.arg
(6) Notes

(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.

(2) File storage location

(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.

(4) Specifiable keys

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

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 nameOverviewDefault value
add.jvm.argThis key invokes JavaVM by using the specified option.
For details about the JavaVM options that can be specified in add.jvm.arg, see 3.2(5)(a) JavaVM options that can be specified with the add.jvm.arg key for batch servers.
For details about default values, see 3.2(5)(b) Default values of JavaVM options for batch servers.
add.class.pathSpecify JAR for the 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.enabledDo 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.versionSpecify 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.directoryStart 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.directorySpecify the output location directory of the log file.
  • In Windows
    Cosminexus-working-directory\ejb\server-name\logs
  • In UNIX
    Cosminexus-working-directory/ejb/server-name/logs
ejb.server.log.modeSpecify the output format of the log file.7
ejb.server.log.stdout.filesizeSpecify the upper-limit for the size of the cjstdout.log file.1048576​
ejb.server.log.stderr.filesizeSpecify the upper-limit for the size of the cjstderr.log file.1048576​
jvm.typeSpecify the type of JavaVM to be used.server
#
If both the add.library.path and OS environment variables (such as LIBPATH) are set up when executing the cjstartsv command or cjstartweb command, the add.library.path settings have a higher priority.

(5) JavaVM options that can be specified with add.jvm.arg

This section describes the JavaVM options that you can specify with add.jvm.arg and the default values for batch servers.

(a) JavaVM options that can be specified with the add.jvm.arg key for batch servers

This subsection describes the JavaVM options that you can specify with the add.jvm.arg key for batch servers. 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 about 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 JavaVM options that you can specify with the add.jvm.arg key for batch servers:

(b) Default values of JavaVM options for batch servers

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

(6) Notes