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