DESTINATION_FILE - UPIMERGE configuration option
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.