The dcjchconf command sets the value of an operand in the system definition file or the operation script file.

When setting the value of an operand with this command, you must enclose the name of the operand with at marks (@) in the target file as shown below:

Setting the value of node_id

set node_id = @DCNODE_ID@

When you execute the dcjchconf command, the operand name enclosed in at marks (@) is converted to the value set in the applicable operand in the dcjchconf command.

-f file-name~<path name>

Specifies the path for the file containing the operand whose value you want to specify or the path for the directory containing this file.

When you specify a directory, all the files in the specified directory are subject to processing.

If you omit this option, all the files in $DCCONFPATH are subject to processing.

-n

Does not insert a linefeed character after the value of the operand has been set.

If you omit this option and the length of one line exceeds 80 bytes after the operand value is set, OpenTP1 inserts a continuation character (\) as the 80th byte and inserts a new line.

If you do not want to insert a new line, specify the -n option.

operand-name~<character string of 1-4096 characters>

For operand-name, specify a character string prefixed with DC.

operand-value~<character string of 1-4096 characters>

Specifies the value to be set for the operand.

• The dcjchconf command creates a directory named .dcjchconf in the directory containing the file specified by the -f option (or in the directory specified by the -f option) and makes a backup copy of the old file. If the dcjchconf command fails to specify the value of an operand, use the backup file in the .dcjchconf directory to restore the original file.
• The dcjchconf command creates a temporary file named .dcjchconf.tmp in the directory containing the file specified by the -f option (or in the directory specified by the -f option). If the dcjchconf command fails during execution, the temporary file may remain.
• The dcjchconf command ends normally even if the specified operand name is not found in the target file.

(1) Specifying smpl for node_id in the $DCCONFPATH/betranrc file

dcjchconf -f $DCCONFPATH/betranrc DCNODE_ID smpl

$DCCONFPATH/betranrc before the dcjchconf command is executed

set node_id = @DCNODE_ID@

$DCCONFPATH/betranrc after the dcjchconf command is executed

set node_id = smpl

(2) Specifying hostA and hostB for all_node in the $DCCONFPATH/betranrc file when the value of the operand to be specified contains a double quotation mark (")

dcjchconf -f $DCCONFPATH/betranrc DCALL_NODE '"hostA","hostB"'

$DCCONFPATH/betranrc before the dcjchconf command is executed

set all_node = @DCALL_NODE@

$DCCONFPATH/betranrc after the dcjchconf command is executed

set all_node = "hostA","hostB"

To include a double quotation mark (") in the value of the operand to be specified, enclose the value in single quotation marks ('). To include a space character in the value of the operand to be specified, enclose the value in double quotation marks (") or single quotation marks (').

If your OS is Windows and you want to include a double quotation mark (") in the value of the operand to be specified, write \" instead of the double quotation mark ("). To include a space character in the value of the operand to be specified, enclose the value between double quotation marks (").