Description

The BACKUP_DESTINATION option instructs UPIMERGE to create a copy of the original configuration or component definition file specified by DESTINATION_FILE before merging the contents of SOURCE_FILE into it.

UPIMERGE creates the backup file in the same directory as the original configuration or component definition file.

UNIX

The format of the file name UPIMERGE generates is implementation-dependent.

On most systems, the format is xxxnnnnnn, where:

xxx is a prefix based on the name of the Universal Agent configuration or component definition file specified for DESTINATION_FILE. (UPIMERGE uses a default of uim if it does not recognize the file name.)
nnnnnn is a unique alpha\-numeric identifier.

On some older UNIX systems, the format is undefined, but the name is still unique.

Windows

UPIMERGE generates a file name with a format of xxxnnnn.tmp, where:

xxx is a prefix based on the name of the Universal Agent configuration or component definition file specified for DESTINATION_FILE. (UPIMERGE uses a default of uim if it does not recognize the file name.)
nnnn is a unique alpha-numeric identifier.

UPIMERGE reports the backup file it generates with message ID UNV4412I.

Usage

Method	Syntax	IBM i	HP NonStop	UNIX	Windows	z/OS
Command Line, Short Form	n/a
Command Line, Long Form	-bkup_dest option
Environment Variable	UIMBKUPDEST=option

Values

option specifies whether UPIMERGE creates a copy of the original configuration or component definition file.

Valid values for option are:

yes
Create a backup of the file specified with DESTINATION_FILE before merging the contents of SOURCE_FILE into it.
no
Merge the contents of SOURCE_FILE into DESTINATION_FILE, without saving a copy of the original DESTINATION_FILE.

Default is no.

Browser not supported