Verwenden Sie die Script-Anweisung :INCLUDE, um ein Include-Objekt aus einem anderen Objekt aufzurufen. Bei jeder Aktivierung eines Objekts, das diese Script-Anweisung enthält, wird das im Include-Objekt gespeicherte Script eingefügt.
Viele Objekte benötigen die gleichen Verarbeitungsschritte in ihren Scripts. Mit Include-Objekten können Sie wiederverwendbare Script-Blöcke schreiben, so dass Sie nicht wiederholt dieselben Scripte schreiben müssen. Weitere Informationen finden Sie unter Includes (JOBI).
Tipps:
- Der Aufruf eines :INCLUDE-Objekts in Ihrem Script ist eine Möglichkeit, Scripte wiederzuverwenden. Weitere Informationen finden Sie unter Scriptkomponenten wiederverwenden.
- Sie können Inhalte aus einem Include-Objekt im Script-Editor anzeigen und kopieren. Weitere Informationen finden Sie unterInclude-Objekte in Scripts verwenden.
Syntax
:INC[LUDE] Include object [oldString = newString][,NOFOUND=IGNORE][,EXT_REPORT=OFF]
Parameter
- :INCLUDE
Ruft ein Include-Objekt auf - Include object
Name des aufzurufenden Include-Objekts
Geben Sie den vollständigen Namen des Include-Objekts ein. Sie können keine Script-Variablen verwenden. - oldString = newString
(Optional) Ersetzen Sie eine Zeichenkette im Script des Include-Objekts durch eine neue Zeichenkette
Hinweis: Ersetzungen sind nur für die aktuelle Generierung gültig und ändern das Include-Objekt selbst nicht.
Format: Script-Literal
Maximale Länge: 50 Zeichen - NOFOUND=IGNORE
(Optional) Es tritt kein Fehler auf, wenn das angegebene Include-Objekt nicht gefunden wird. - EXT_REPORT_OFF
(Optional) Verzichtet auf die Protokollierung von Objektinhalten in erweiterten Reports und gibt stattdessen eine Befehlszeile aus
Beispiele
Die folgende Anweisung ruft ein Include-Objekt namens MM.FILEASSIGNMENTS auf.
:INC MM.FILEASSIGNMENTS
Die folgende Anweisung ruft das gleiche Objekt auf und gibt einen neuen Namen an.
:INC MM.FILEASSIGNMENTS "$MM." = "$MMTEST."
Das folgende Beispiel ruft ein benutzerdefiniertes Include-Objekt auf. Es tritt kein Fehler auf, wenn das Objekt nicht gefunden wird.
:INCLUDE HEADER.WINDOWS.USER.HEAD ,NOFOUND=IGNORE
Das folgende Beispiel unterdrückt die Protokollierung des Inhalts des Include-Objekts in den erweiterten Reports.
:INC MM.FILEASSIGNMENTS ,EXT_REPORT=OFF
Siehe auch: