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

(tick)

(tick)

Environment Variable

UIMDESTFILE=filename

(tick)

(tick)

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.