Description

The DESTINATION_FILE option identifies the configuration or component definition file that UPIMERGE uses to store the results of the merge with SOURCE_FILE.

During the merge process, UPIMERGE replaces all values in DESTINATION_FILE that have a match in SOURCE_FILE. If SOURCE_FILE contains configuration or component definition options not defined in DESTINATION_FILE, UPIMERGE adds those options to the end of the output file.

UPIMERGE does not attempt to sequence the entries it adds to DESTINATION_FILE, which means the order of options in the output file may not match the order of the same options specified in SOURCE_FILE. In addition, UPIMERGE does not update any comments in the output file. Finally, if the input file contains more than one entry for a given option, UPIMERGE adds every occurrence of that entry to DESTINATION_FILE. The application uses the value of the last entry that appears in the output file.

Options that reside only in DESTINATION_FILE are either commented out or left as-is, depending on the value of the KEEP_NOMATCH option.

The file name specified for DESTINATION_FILE must exist (even if it is empty) before executing UPIMERGE.

Usage

Method	Syntax	IBM i	HP NonStop	UNIX	Windows	z/OS
Command Line, Short Form	n/a
Command Line, Long Form	-dest filename
Environment Variable	UIMDESTFILE=filename

Values

filename is the name of the file that contains the results of the merge with SOURCE_FILE.

filename can contain a complete path to the output file or a path relative to the current directory.