BACKUP_DESTINATION - UPIMERGE configuration option

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



(tick)

(tick)


Environment Variable

UIMBKUPDEST=option



(tick)

(tick)


Values

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

Valid values for option are:

Default is no.