3.2.5 usrconf.cfg (Option definition file for batch applications)
- Organization of this subsection
(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.
-
Specify the path in CJBATCHUSRCONFDIR using an absolute path.
-
(2) File storage location
Set up the path for the storage location of usrconf.cfg (option definition file for batch applications) in the environment variable CJBATCHUSRCONFDIR or store usrconf.cfg (option definition file for batch applications) in the directory that executes the commands used for batch applications. When you execute the commands used for batch applications, the usrconf.cfg file (option definition file for batch applications) will be searched in the following order:
-
Directory set in environment variable (CJBATCHUSRCONFDIR)
-
Directory where cjexecjob command (batch application execution command) is executed
(3) Functionality
This file specifies the invocation options for JavaVM that execute batch applications.
If you change the contents of this file while a batch application is running, the changes become effective only when the batch application is started next time.
(4) Defined values
When you execute commands that are used with batch applications, the enabled options will differ depending on whether the scheduling functionality is used.
The following table describes the values defined for each command used with batch applications:
Option name |
cjexecjob |
cjkilljob |
cjlistjob |
|||
---|---|---|---|---|---|---|
Scheduling functionality is not used |
Scheduling functionality is used |
Scheduling functionality is not used |
Scheduling functionality is used |
Scheduling functionality is not used |
Scheduling functionality is used |
|
add.jvm.arg |
Y |
Y |
N |
N |
N |
N |
add.class.path |
Y |
Y |
N |
N |
N |
N |
batch.ctm.enabled |
Y |
Y |
Y |
Y |
Y |
Y |
batch.log.directory |
Y |
Y |
Y |
Y |
Y |
Y |
batch.log.lockInterval |
Y |
Y |
Y |
Y |
Y |
Y |
batch.log.lockRetryCount |
Y |
Y |
Y |
Y |
Y |
Y |
batch.log.maintenance.filenum |
Y |
Y |
Y |
Y |
Y |
Y |
batch.log.maintenance.filesize |
Y |
Y |
Y |
Y |
Y |
Y |
batch.log.message.filenum |
Y |
Y |
Y |
Y |
Y |
Y |
batch.log.message.filesize |
Y |
Y |
Y |
Y |
Y |
Y |
batch.log.stdout.enabled |
Y |
Y |
N |
N |
N |
N |
batch.request.timeout |
N |
Y |
N |
Y |
N |
Y |
batch.schedule.group.name |
N |
Y |
N |
Y |
N |
Y |
batch.vbroker.agent.addr |
N |
Y |
N |
Y |
N |
Y |
batch.vbroker.agent.port |
N |
Y |
N |
Y |
N |
Y |
- Legend:
-
Y: Option is enabled.
N: Option is disabled.
(5) Specifiable keys
The following table describes the specifiable keys and the default values:
- Important note
-
If you use multibyte characters within the file, integrate the multibyte characters and encode used in the following locations:
-
usrconf.cfg (option definition file for batch servers)
-
Arguments of the cjexecjob command (batch application execution command)
-
Source code of the batch application (java.lang.System.out or java.lang.System.err)
-
Key name |
Contents |
Default value |
---|---|---|
Pass the specified value to batch application on the batch server. You can specify the following option:
You can specify the following properties:
Note that if you want to specify a system property, specify the value in the usrconf.properties file without using -D. |
None |
|
Add the setup value to the class path of the batch application class loader on the batch server. You can specify only one JavaVM option for this key. If you specify multiple JavaVM options, add new add.class.path. 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. To specify the JAR files for the container extension library, specify the add.class.path key in the option definition file for batch servers. |
None |
|
Specify whether to use the scheduling functionality.
|
false |
|
Specify the output location directory of the log file. Specify the path of the log output location with absolute path or the relative path. You can specify following characters:
When the path (including the absolute and relative path up to the current directory when the relative path is specified) that exceeds 180 bytes is specified, a message KDJE40059-W is output, and hence the default value is used. When the default value exceeds 180 bytes, log initialization fails and terminates abnormally. When there is no access permission to directory, or when the file name is specified, a message KDJE55039-W is output and command ends. In Windows, you cannot specify a path that includes a UNC name. In UNIX, you cannot specify a path of an nfs-mounted disk. |
Cosminexus-installation-directory\CC\batch\logs |
|
Specify the retry interval (unit: milliseconds) as integers from 0 to 2147483647 for failure in an attempt of exclusive processing of log files. If 0 is specified, an error occurs immediately. The commands in batch applications are used to output the KDJE55042-E message and terminate the process. In Windows, specify the value acquired by multiplying the batch.lockRetryCount value and batch.log.lockInterval value in a range from 0 to 2147483647. In Windows use the value acquired by multiplying the batch.log.lockRetryCount value and batch.log.lockInterval value as the wait time of exclusive process. |
10 |
|
If the exclusive process of the log file fails, specify the retry frequency (unit: times) in integers from 1 to 2147483647. The commands in batch applications are used to output the KDJE55042-E message and terminate the process. |
1000 |
|
Specify the number of log files for saving commands to be used in batch applications. Specify integers from 1 to 64. To change the number of files, stop all commands used in the batch application that are output to the corresponding log files (cjexecjob, cjkilljob, and cjlistjob) and move or delete the log files and the log management files under the mmap directory to another directory. |
2 |
|
Specify the file size (unit: bytes) of the log file for saving commands to be used in batch applications. Specify integers from 4096 to 16777216. To change the size, stop all commands used in the batch application that are output to the corresponding log files and move or delete the log files and the log management files under the mmap directory to another directory. |
1048576 |
|
Specify the number of message log files of the commands to be used in batch applications. Specify integers from 1 to 64. To change the number of files, stop all commands used in the batch application that are output to the corresponding log files and move or delete the log files and the log management files under the mmap directory to another directory. |
2 |
|
Specify the file size (unit: bytes) of the message log file of the commands to be used in batch applications. Specify integers from 4096 to 16777216. To change the size, stop all commands used in the batch application that are output to the corresponding log files and move or delete the log files and the log management files under the mmap directory to another directory. |
1048576 |
|
Specify whether to output the messages issued by the batch job input command, with the standard output of batch execution commands.
|
true |
|
Specify from 0 to 2147483647 (unit: seconds) as a timeout value for the communication between batch execution commands and batch servers. If you specify 0, the operation continues to wait infinitely. |
0 |
|
Specify a string of 1 to 63 characters having alphanumeric characters and underscore (_) as the schedule group name of batch servers. |
JOBGROUP |
|
Specify the IP address that OSAgent is using. You specify this key in the environment in which multiple IP addresses are distributed. |
None |
|
Specify an integer from 1 to 65535 as the port number for connecting to OSAgent. |
14000 |
(6) Notes
-
For the add.jvm.arg key, do not specify the --add-modules or --module-path option. If you do so, operations are not guaranteed.