Specify the key as follows:
key-name=value
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:
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.
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 |
The following table describes the specifiable keys and the default values:
Table 3-3 Specifiable keys and default values for usrconf.cfg (Batch applications)
Key name | Contents | Default value |
---|---|---|
add.jvm.arg | Pass the specified value to batch application on the batch server. You can specify the following option:
You can specify the following properties:
| None |
add.class.path | 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 |
batch.ctm.enabled | Specify whether to use the scheduling functionality.
| false |
batch.log.directory | 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:
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 |
batch.log.lockInterval | 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 |
batch.log.lockRetryCount | 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 |
batch.log.maintenance.filenum | 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 |
batch.log.maintenance.filesize | 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 |
batch.log.message.filenum | 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 |
batch.log.message.filesize | 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 |
batch.log.stdout.enabled | Specify whether to output the messages issued by the batch job input command, with the standard output of batch execution commands.
| true |
batch.request.timeout | 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 |
batch.schedule.group.name | Specify a string of 1 to 63 characters having alphanumeric characters and underscore (_) as the schedule group name of batch servers. | JOBGROUP |
batch.vbroker.agent.addr | Specify the IP address that OSAgent is using. You specify this key in the environment in which multiple IP addresses are distributed. | None |
batch.vbroker.agent.port | Specify an integer from 1 to 65535 as the port number for connecting to OSAgent. | 14000 |