Description

The ALLOW_REPL_ON_RENAME option specifies whether or not the UDM rename command will succeed if the new file name provided in that command matches the name of an existing file.

Note

Starting with UDM 5.2.0.6, delivered in the Universal Agent 5.2.0.11 maintenance release, the default behavior for a rename command executed from a UNIX or z/OS (when using the HFS file system) UDM session was changed to fail if the new file name matches the name of an existing file.

This was done to ensure consistency across platforms and to preserve the platform-independent nature of the UDM scripting environment.

ALLOW_REPL_ON_RENAME is provided to allow existing applications that rely on the rename command to replace existing files to continue executing with pre-5.2.0.6 behavior.

New scripts should be written in a way that expects the rename command to fail if the target file already exists. This currently is the behavior when a UDM session is opened on a Windows system.

Usage

Method	Syntax	IBM i	UNIX	Windows	z/OS
Command Line, Short Form	n/a
Command Line, Long Form	-allow_repl_on_rename option
Environment Variable	UDMALLOWREPLONRENAME=option
Configuration File Keyword	allow_repl_on_rename option
STRUDM Parameter	n/a

Values

option specifies whether or not an existing file will be replaced by the rename command.

Valid values for option are:

yes
If the target file specified in the rename command exists, it will be replaced.
no
If the target file specified in the rename command exists, the rename command will fail.

Default is no.

Browser not supported