Description

The SOURCE_FILE option identifies the file that UPIMERGE merges into the configuration or component definition file specified by the DESTINATION_FILE option.

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. If SOURCE_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.

Use of SOURCE_FILE is optional; it also is possible to provide input options and values to UPIMERGE using standard input (that is, stdin) redirection.

The following illustrates an example of stdin redirection.

upimerge -dest outfile.txt

Note

It is possible to execute UPIMERGE without the redirected input file. However, the program may appear unresponsive. In this situation, UPIMERGE is actually waiting for an end-of-file indicator to signal the end of the redirected input.

Windows	Supply the end-of-file indicator by pressing <Ctrl+Z> <Enter>.
UNIX	Supply the end-of-file indicator by pressing <Ctrl+D>.

Usage

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

Values

filename is the name of the file that contains options and values that UPIMERGE merges into DESTINATION_FILE.

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

Browser not supported