DUPLICATE_OBJECT

Use the DUPLICATE_OBJECT script function to create a duplicate of an object.

Important!

  • A runtime error occurs if you use an :ON_ERROR statement with the ABEND parameter, but the object or the folder does not exist. The object remains in its original folder if the folder does not exist. For more information, see :ON_ERROR.
  • You need write access (W) to the object and the target folder, as a runtime error will occur otherwise. For more information, see Granting Automation Engine Authorizations.
  • This script function writes all open transactions of the script to the AE database. For more information, see Script Processing.

Syntax

DUPLICATE_OBJECT (Object Name,Template,[Folder])

Parameters

  • DUPLICATE_OBJECT
    Duplicates an object to a folder
  • Object Name
    Name of the target object
    Format: script literal or script variable
  • Template
    Name of the source object that should be duplicated.
    Format: script literal or script variable
  • (Optional) Folder
    Path of the folder to which you want to duplicate the object.
    Format: script literal or script variable

Return codes

The script function returns the following codes:

  • 0
    The object was successfully duplicated.
  • 20645
    This object does not exist.
  • 20657
    The target folder does not exist.

Example

The following example duplicates the SCRI.SOURCE Script object and names it TARGET.


:
SET &target_object# = "SCRI.TARGET_&$PHYS_DATE_YYYY_MM_DD_p#_&$_PHYS_TIME_HHMMSS#"

:SET &retcode# = DUPLICATE_OBJECT(&target_object#,SCRI.SOURCE,"\DUPLICATE_OBJECT\TEST")

:PRINT &retcode#

The duplicated object now shows the name SCRI.TARGET_2023_10_17_155414:

See also: