DUPLICATE_OBJECT

Verwenden Sie die Script-Funktion DUPLICATE_OBJECT, um ein Duplikat eines Objekts zu erstellen.

Wichtig!

• Ein Laufzeitfehler tritt auf, wenn Sie eine :ON_ERROR-Anweisung mit dem Parameter ABEND verwenden, aber das Objekt oder der Ordner nicht vorhanden ist. Falls der Ordner nicht vorhanden ist, verbleibt das Objekt in seinem ursprünglichen Ordner. Weitere Informationen finden Sie unter:ON_ERROR.
• Sie benötigen Schreibzugriff (W) auf das Objekt und den Zielordner, da andernfalls ein Laufzeitfehler auftritt. Weitere Informationen finden Sie unter Gewähren von Automation Engine-Berechtigungen.
• Diese Script-Funktion schreibt alle offenen Transaktionen des Scripts in die AE-Datenbank. Weitere Informationen finden Sie unter Script-Verarbeitung.

Syntax

DUPLICATE_OBJECT (Object Name,Template,[Folder])

Parameter

• DUPLICATE_OBJECT
  Dupliziert ein Objekt in einen Ordner
• Objektname
  Name des Zielobjekts
  Format: Script-Literal oder Script-Variable
• Vorlage
  Name des Quellobjekts, das dupliziert werden sollte.
  Format: Script-Literal oder Script-Variable
• (Optional) Ordner
  Pfad des Ordners, in den Sie das Objekt kopieren möchten.
  Format: Script-Literal oder Script-Variable

Rückgabewerte

Die Script-Funktion gibt die folgenden Werte zurück:

• 0

  Das Objekt wurde erfolgreich dupliziert.

• 10000

  Das Quellobjekt ist nicht vorhanden.

• 20644

  Es ist bereits ein Objekt mit dem Zielnamen vorhanden.

• 20657

  Der Zielordner existiert nicht.

Beispiel

Im folgenden Beispiel wird das Script-Objekt SCRI.SOURCE dupliziert und TARGET genannt.

: 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#

Das duplizierte Objekt heißt nun „SCRI.TARGET_2023_10_17_155414“:

Siehe auch: