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