:ATTACH_RES
Script-Anweisung: Diese Anweisung wird in Verbindung mit dem Storage-Objekt verwendet, um die Ressourcen anzugeben, die Sie mit dem UNIX- oder Windows-Agenten verwenden möchten. Sie können sie in einem Script im auf der Prozess-Seite von Jobobjekten (JOBS) unter Windows oder UNIX verwenden.
Syntax
: ATTACH_RES Objektname, Ressourcenname, [Nutzung], [Variable]
|
Schlüssel |
Beschreibung/Format |
|---|---|
| Objektname |
Name des Storage-Objekts |
| Ressourcenname | Name der Ressource, die Sie anhängen, d. h. an den Agenten übertragen möchten. |
| Nutzung |
Erlaubte Werte:
Standardwert: "T" |
| Variable |
(optional) Ein Automation Engine-Variablenersatz wird für eine Speicherressource vom Typ Text unmittelbar vor der Übertragung an den Agenten durchgeführt. Zulässige Werte: "Y"[es] oder "N"[o] Standardwert: "N" Achtung! Dieser Schlüssel kann nur für Ressourcen mit folgenden Attributen verwendet werden: Typ = "Text" und Nutzung = "Aufgabenspezifisch" |
Hinweise: Sie können die folgenden Systemvariablen mit :ATTACH_RES verwenden, um Informationen über die absoluten Pfade von Ressourcen zu erhalten:
| Variablenname | Systemstandort |
|---|---|
| &$AGENT_RESOURCES_CLIENT# | Mandantenübergreifendes Cache-Verzeichnis |
| &$AGENT_RESOURCES_TASK# | Aufgabenspezifisches Cache-Verzeichnis |
Hinweis: Da Ressourcen an das Storage-Objekt gebunden sind, werden Pfade im Automation Engine-System definiert, sind aber für den Benutzer nicht sichtbar. Mit diesen Variablen können Sie sich Details im Report des Auftragsobjekts anzeigen lassen.
Diese Script-Anweisung bestimmt die Ressourcen, die an das Storage-Objekt angehängt werden müssen, um sie an den Betriebssystemagenten zu übertragen, entweder unter Windows oder unter UNIX.
Hinweis: Der Agent erstellt eine Liste aller zu übertragenden Dateien für einen Auftrag, in dem :ATTACH_RES angegeben ist. Wenn die Übertragung der aufgelisteten Dateien nicht erfolgreich ist, bricht der Agent den Auftrag ab.
Hinweis: Da der Agent Informationen über Betriebssystem, Hardware und Plattform an das Automation Engine-System überträgt, überträgt das Automation Engine-System nur Ressourcen aus dem Storage-Objekt, die diesen Werten entsprechen.
Hinweise: Sie können Ressourcen auch in ein spezielles Verzeichnis übertragen, indem Sie :ATTACH_RES zuerst verwenden und dann Dateien mit einem externen Script kopieren.
Achtung! Die Größe der Ressourcen ist begrenzt. Ab Version können Sie bis zu 95 MB (99.900.000 Byte) anhängen und übertragen.
Um einen niedrigeren Grenzwert festzulegen, verwenden Sie den Schlüssel MAXIMUM_STORE_RESOURCE_SIZE in den Systemeinstellungen. Weitere Informationen finden Sie unter UC_SYSTEM_SETTINGS - Systemübergreifende Einstellungen.
Achtung! In einer Ressource des Typs Text werden Systemvariablen nur dann durch die entsprechenden Werte ersetzt, wenn dieselbe Systemvariable auf der Prozess-Seite verwendet wird. Dies hat Leistungsgründe.
Achtung! Wenn Sie versuchen, Ressourcen vom Typ Text mit Variablenersetzung, die auf "Yes" gesetzt sind, in den mandantenübergreifenden Cache zu übertragen, wird eine Fehlermeldung angezeigt.
Beispiele
Im folgenden Beispiel werden alle im Speicherobjekt enthaltenen Ressourcendateien übertragen:
: ATTACH_RES "STORAGE12", "*"
Dieses Beispiel überträgt alle Ressourcen, bei denen der Name mit dem Ausdruck "file" beginnt
: ATTACH_RES "STORAGE12", "file*"
Das dritte Beispiel überträgt alle Ressourcen in einen mandantenübergreifenden Cache.
: ATTACH_RES "STORAGE12", "*", C
In diesem Beispiel wird ein Variablenersatz für alle übertragenen Dateien durchgeführt:
: ATTACH_RES "STORAGE12", "*.ini", ,Y
In diesem Beispiel werden die oben genannten Systemvariablen für :ATTACH_RES verwendet, um eine .jar-Datei anzuhängen, die dann mit Java gestartet wird:
: ATTACH_RES "PCK.AUTOMIC_SIEBEL.PRV.STORE", "SIEBELTOOL.JAR", C
JAVA -JAR "&$AGENT_RESOURCES_CLIENT#SIEBELTOOL.JAR" SIEBEL IMPORTBUSINESSOBJECT
Siehe auch: