:INCLUDE

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, sodass Sie nicht wiederholt dieselben Scripts schreiben müssen. Weitere Informationen finden Sie unter Includes (JOBI).

Tipps:

• Der Aufruf eines :INCLUDE-Objekts in Ihrem Script ist eine Möglichkeit, Scripts wiederzuverwenden. Weitere Informationen finden Sie unter Script-Komponenten 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-Objekt [alterString = neuerString][,NOFOUND=IGNORE][,EXT_REPORT=OFF]

Parameter

• :INCLUDE
  Ruft ein Include-Objekt auf

• Include-Objekt
  Name des aufzurufenden Include-Objekts
  Geben Sie den vollständigen Namen des Include-Objekts ein. Sie können keine Script-Variablen verwenden.

• alterString = neuerString
  (Optional) Ersetzt einen String im Script des Include-Objekts durch einen neuen String
  Hinweis:Ersetzungen sind nur für die aktuelle Generation gültig und ändern nicht das eigentliche Include-Objekt.
  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) Lässt den Inhalt von Include-Objekten beim Logging in erweiterten Reports weg 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 das Logging des Inhalts des Include-Objekts in den erweiterten Reports. 

: INC MM.FILEASSIGNMENTS ,EXT_REPORT=OFF

Siehe auch: