:ATTACH_RES

Verwenden Sie die Script-Anweisung :ATTACH_RES mit einem Speicherobjekt, um die Ressourcen zu definieren, die Sie an den UNIX- oder Windows-Agent anhängen und übertragen möchten. Sie können diese Script-Anweisung auf der Seite Prozess von Windows- oder UNIX-Job-Objekten (JOBS) verwenden.

Hinweise:

  • In einem Job, der :ATTACH_RES verwendet, erstellt der Agent eine Liste aller Dateien, die übertragen werden sollten. Wenn die Übertragung der aufgelisteten Dateien fehlschlägt, bricht der Agent den Auftrag ab.
  • Der Agent überträgt Informationen über das Betriebssystem, die Hardware und die Plattform an das Automation Engine-System. Jedoch überträgt das Automation Engine-System nur die Ressourcen vom Speicherobjekt, die den angegebenen Werten entsprechen. Weitere Informationen finden Sie unter Storage (STORE)
  • Sie können Ressourcen unter Verwendung von ATTACH_RES in ein vordefiniertes Verzeichnis übertragen und danach mit einem externen Script kopieren. Verwenden Sie dazu die Systemvariablen &$AGENT_RESOURCES_CLIENT# und &$AGENT_RESOURCES_CLIENT#.

Syntax

: ATTACH_RES Objektname, Ressourcenname, [Nutzung], [Variable]

Parameter

  • :ATTACH_RES
     Legt fest, welche Ressourcen an das Speicherobjekt für die Übertragung an einen Windows- oder UNIX-Agent für Betriebssysteme angehängt werden sollen.

  • Objektname
    Name des Speicherobjekts.

  • Ressourcenname
    Name der Ressource, die angehängt und an den Agenten übertragen werden soll
    Wichtig!

    • Die Größe der Ressourcen ist auf 95 MB (99900000 Byte) begrenzt.
      Administratorbenutzer können diese Größe verringern, indem sie die Speichergröße mit dem Schlüssel MAXIMUM_STORE_RESOURCE_SIZE in der Systemvariablen UC_SYSTEM_SETTINGS auf einen niedrigeren Wert setzen. Weitere Informationen finden Sie unterUC_SYSTEM_SETTINGS - Systemübergreifende Einstellungen.
    • Wenn Ressourcen mit dem Speicherobjekt verbunden sind, legt das Automation Engine-System die entsprechenden Pfade fest. Diese Pfade sind für den Benutzer nicht sichtbar. Mithilfe der folgenden Systemvariablen können Sie die Details und absoluten Pfade der Ressource anzeigen, die im Report des Jobobjekts angezeigt werden:
      • &$AGENT_RESOURCES_CLIENT#
        Mandantenweites Cache-Verzeichnis
      • &$AGENT_RESOURCES_TASK#
        Aufgabenspezifisches Cache-Verzeichnis

      • Weitere Informationen finden Sie im letzten Beispiel dieses Themas oder in der Liste der Systemeigenschaften

  • Verwendung
    (Optional) Legt fest, ob ein aufgabenspezifischer oder ein mandantenweiter Zwischenspeicher verwendet wird.
    Zulässige Werte:

    • T (Standard)
      Aufgabenspezifischer Wert, es wird ein aufgabenspezifischer Cache verwendet, um die Ressourcendateien zu übertragen. Die Aufgabenressourcen sind verfügbar, während der Job ausgeführt wird, und sind nur für den Job sichtbar. Diese Ressourcen werden gelöscht, wenn der Job endet.
    • C
      Mandantenweiter Wert, es wird ein mandantenweiter Cache verwendet, um die Ressourcendateien zu übertragen. Die Ressourcen verbleiben im Cache und werden beispielsweise nur aktualisiert, wenn die Automation Engine einen neuen Zeitstempel erhält.

  • Variable
    (Optional) Eine Variable Automation Engine wird durch eine Textspeicherressource ersetzt, unmittelbar bevor sie zum Agenten übertragen wird.
    Zulässige Werte:

    • N[o] (Standard)
    • Y[es]

    • Wichtig!

    • Stellen Sie sicher, dass es sich bei der Speicherressource um einen Texttyp handelt, und dass der in Verwendung definierte Wert T (aufgabenspezifischer Cache) ist. Eine Fehlermeldung wird angezeigt, wenn Sie Ressourcen des Texttyps übertragen und der Variablenersatz auf Ja, auf C (mandantenweiter Cache) gesetzt ist.
    • Aus Leistungsgründen werden Systemvariablen in einer Texttypressource nur durch ihre entsprechenden Werte ersetzt, wenn dieselbe Systemvariable auf der Seite Prozess verwendet wird.

Beispiele

Das folgende Beispiel überträgt alle Ressourcendateien, die das angegebene Speicherobjekt enthält:

: ATTACH_RES "STORAGE12", "*"

Dieses Beispiel überträgt alle Ressourcen, deren Namen mit dem Wort "file" beginnen:

: ATTACH_RES "STORAGE12", "file*"

Das dritte Beispiel überträgt alle Ressourcen in einen mandantenweiten Cache.

: ATTACH_RES "STORAGE12", "*", C

Dieses Beispiel ersetzt eine Variable in allen Dateien, die übertragen werden sollen:

: ATTACH_RES "STORAGE12", "*.ini", ,Y

Das letzte Beispiel verwendet die Systemvariable &$AGENT_RESOURCES_CLIENT# für :ATTACH_RES, um eine .jar-Datei anzufügen, die mit Java beginnt:

Siehe auch: