Registerkarte Pre-Script

Script-Registerkarten

Registerkarte Post-Script

---

 Registerkarte Script

Die Registerkarte Script ist eine objekttypspezifische Registerkarte, in welcher Verarbeitungsanweisungen in der Script-Sprache von AE hinterlegt werden.

Objekt: Job
Objektklasse: Ausführbares Objekt
Objekttyp (Kurzbezeichnung): JOBS

Beschreibung

Das Script wird entweder bei der Aktivierung des Jobs oder bei dessen Start prozessiert. Das ist abhängig von der Einstellung "Zur Laufzeit generieren", die sich in der Registerkarte Attribute befindet.

Verarbeitungsanweisungen, die noch im Header prozessiert (z.B. Setzen von bestimmten Host-Attributen) oder vor dem Start des Jobmelders ausgeführt werden sollen, müssen in der Registerkarte Pre-Script eingetragen werden.

Verarbeitungsanweisungen, die erst nach dem Ende des Jobs prozessiert werden sollen, werden in der Registerkarte Post-Script hinterlegt. Durch diese Verarbeitung kann das endgültige Ende eines Jobs beeinflusst werden.

Die DATA-Zeilen entsprechen der jeweiligen JCL (Job Control Language) des Zielsystems und werden 1:1 von AE an das Zielsystem übergeben. DATA-Zeilen können beispielsweise BS2000-Kommandos oder MS-DOS-Befehle für eine Batchverarbeitung enthalten.

Spezielle Funktionen für Guardian/NSK

Für die automatisierte Behandlung von Eingabeaufforderungen stehen Ihnen spezielle Funktionen zur Verfügung.

JCL für z/OS

Hier wird die eigentliche JCL angegeben. Keinesfalls darf hier eine Jobkarte (diese wird über die Attribute angegeben) bzw. Endekarte spezifiziert werden.

SAP JCL interpretiert vom SAP-Agent

Da es in SAP keine JCL gibt, wurde in der AE eine SAP-JCL definiert. Der SAP-Agent analysiert diese und setzt sie in Verarbeitungsanweisungen für das Zielsystem um.

Aktivieren eines Interpreters für Windows

Sie können auch ein Script für die Verwendung mit einem externen Interpreter eingeben. Um die Interpretation eines solchen Scripts zu ermöglichen, verwenden Sie :BEGIN_EXT_INTERPRETER und :END_EXT_INTERPRETER.
Die Binärdateien des Storage-Objekts können zudem mithilfe der Script-Funktion :ATTACH_RES angehängt und an den Windows-Agenten übertragen werden.
Einzelheiten zu diesen Funktionen sind bei den entsprechenden Themen näher beschrieben.

Damit Sie diese Funktionen nutzen können, müssen Sie folgende Variablen konfigurieren: UC_EXT_INTERPRETERS_WINDOWS und :REGISTER_VARIABLE.

Aktivieren eines Interpreter für UNIX

Für UNIX gilt die gleiche Bedingung wie oben: Sie können ein Script für die Verwendung mit einem externen Interpreter eingeben. Um die Interpretation eines solchen Scripts zu ermöglichen, verwenden Sie :BEGIN_EXT_INTERPRETER und :END_EXT_INTERPRETER.
Die Binärdateien des Storage-Objekts können zudem mithilfe der Script-Funktion :ATTACH_RES angehängt und an den UNIX-Agenten übertragen werden.
Einzelheiten zu diesen Funktionen sind bei den entsprechenden Themen näher beschrieben.

Damit Sie diese Funktionen nutzen können, müssen Sie folgende Variablen konfigurieren: UC_EXT_INTERPRETERS_UNIX und :REGISTER_VARIABLE.

Windows BAT und Powershell Beispiele

Das folgende Windows BAT-Script setzt die Ausgabe des C:\Temp Verzeichnisses in eine Datei und prüft, ob der Befehl erfolgreich ausgeführt wurde. Wurde der Befehl nicht erfolgreich ausgeführt, wird der Job mit dem Rückgabewert aus dem „dir“-Befehl beendet:

dir C:\temp /S >> C:\temp\test.txt
@set retcode=%errorlevel%
@if NOT %ERRORLEVEL% == 0 goto :retcode

Das folgende Windows Powershell-Script erhält Inhalt des C:\Temp Verzeichnisses und setzt den Output in eine Datei. Anschließend wird der Powershell Fehlercode geprüft; ist er nicht gleich 0, wird der Job mit $LastExitCode abgebrochen – dies ist das Äquivalent zu %ERRORLEVEL% im CMD.EXE/.BAT Script.

Get-ChildItem C:\Temp > C:\Temp\test.txt
if( $LastExitCode -ne 0 )
{ __uc_return $LastExitCode }

Die Funktion __uc_return wird im HEADER.WINDOWS Include-Objekt bereitgestellt und kann für die Beendigung von Powershell-Jobs genutzt werden.

Siehe auch:

Scripteditor
Über AE-Scripts
Beispielsammlung
REGISTER_VARIABLE.* - Registriere Variablen oder externe Interpreter