Die Attribute eines Objekts können sowohl dauerhaft als auch nur für eine bestimmte Ausführung des Objekts verändert werden. In diesem Thema wird beschrieben, wie man beides macht.
- Attribute für eine bestimmte Ausführung modifizieren
- Attribute dauerhaft ändern
- Attribute über das Dienstprogramm „AE.DB Change“ ändern
Attribute für eine bestimmte Ausführung modifizieren
Wenn Sie einen Objekttyp definieren, legen Sie die allgemeinen Attribute fest, die dann für alle Objekte dieses Typs gültig sind. In manchen Fällen ist es nötig, bestimmte Einstellungen für die Ausführung eines Objekts zu ändern, ohne die allgemeinen Definitionen zu ändern. Für diesen Zweck können Sie das Objekt auf zwei Arten gestalten:
- Definieren Sie die Include-Objekte (INCL), die bestimmen, welche Felder bei der Ausführung eines Objekts ad hoc verändert werden können.
Hierfür wird der Mandant 0 mit speziellen Include-Objekten ausgestattet, die bereits dafür vorbereitet wurden. Sie können diese anpassen, indem Sie die nicht benötigten :READ-Statements entfernen. So definieren Sie, welche Felder ad hoc bearbeitet werden können. Das Include-Objekt muss sowohl im Mandanten 0 als auch in Ihrem eigenen Mandanten gespeichert werden.
In der Tabelle unten sind die Include-Objekte sowie die zugehörigen Aufrufe pro Objekt aufgelistet:
Ausführbares Objekt
Inkludieren
Include-Aufruf Dateiübertragung
ATTRDIA.FT
Standard-Programmaufrufe
BS2000 job
ATTRDIA.BS2000
HEADER.BS2000
JMX-Job
ATTRDIA.JMX
HEADER.JMX
NSK-Job
ATTRDIA.NSK
HEADER.NSK
z/OS-Job
ATTRDIA.MVS
HEADER.MVS
OS/400-Job
ATTRDIA.OS400
HEADER.OS400
PeopleSoft-Job
ATTRDIA.PS
HEADER.PS
Rapid Automation job ATTRDIA.CIT HEADER.CIT SAP-Job
ATTRDIA.SAP
HEADER.SAP
SAP BW-Job
ATTRDIA.SAPBW
HEADER.SAPBW
Siebel-Job
ATTRDIA.SIEBEL
HEADER.SIEBEL
SQL-Job
ATTRDIA.SQL
HEADER.SQL
UNIX-Job
ATTRDIA.UNIX
HEADER.UNIX
JMS-Job
ATTRDIA.VMS
HEADER.VMS
Windows-Job
ATTRDIA.WINDOWS
HEADER.WINDOWS
- Aktivieren Sie auf der Seite Attribute im Abschnitt Laufzeitparameter die Checkbox Zeige Attribut-Dialog bei Aktivierung, wenn Sie das Objekt definieren.
Die Option Zur Laufzeit generieren muss deaktiviert sein, um die Ad-hoc-Veränderung von Objektattributen zu ermöglichen.
- Aktivieren Sie die Checkbox Attributdialog aktivieren, die bei Neustart oder Ausführung eines Jobs über die Perspektive „Process Assembly“ oder „Process Monitoring“ aufscheint.
Wenn die Aufgabe von der Perspektive „Process Assembly“ oder „Process Monitoring“ ausgeführt (einmalig ausführen) oder neu gestartet wird, erscheint ein Dialog, der die Felder, die im entsprechenden Include-Objekt definiert wurden, anzeigt. Der Benutzer muss daraufhin die Werte, die für dieses Objekt und die aktuelle Ausführung gelten, eingeben. Nach Beendigung werden die hier eingegebenen Werte ungültig und es gelten wieder die allgemeinen Definitionen.
Sie können die Objektattribute zu verschiedenen Zeitpunkten und an verschiedenen Stellen angeben:
- Bei der Definition von Objekten auf der Seite Seite „Attribute“.
-
Einige ausführbare Objekte erlauben die Interaktion mit dem Benutzer. Bei der Ausführung der Objekte kann auf die Attribute zugegriffen und die Objekte können zur Laufzeit modifiziert werden.
- Bei ausführbaren Objekten können Script-Sprachmittel für den Zugriff auf Attribute verwendet werden.
Zum Lesen von Attributen verwenden Sie die Script-Funktion GET_ATT und zum Setzen von Attributen die Script-Funktion :PUT_ATT.
-
Automation Engine bietet spezifische Variablen, die auch Werte von Attributen umfassen. Sie können in Attributfeldern oder in Automation Engine-Scripts verwendet werden. Für die Auswahl steht der Dialog „Variablen hinzufügen“ zur Verfügung (siehe Variablen in Objekte und Scripts einfügen).
Einzelheiten zu Variablen, siehe VARA-Objekte.
-
Manche Attribute können direkt, d.h. ohne den Aufruf von :PUT_ATT, gesetzt werden.
Tragen Sie hierfür im Objekt in den entsprechenden Feldern eine Script-Variable ein. Vor der Ausführung des Objektes wird diese Variable durch den in den Seiten „Script“ definierten Wert oder durch eine Objekteigenschaften-Variable ersetzt.
-
Die folgenden Verknüpfungen enthalten Dokumentationsthemen zu objektspezifischen Attributen.
Beispiel
Das Arbeitsverzeichnis eines Windows-Jobs sollte mithilfe der Variable „&directory#“ festgelegt werden. Tragen Sie auf der Windows-Seite im Eingabefeld Arbeitsverzeichnis die Script-Variable ein.
Das Job-Script füllt die Variable:
:SET &directory# = "C:\temp"
Für die Festlegung des Attributs können Sie alternativ auch die Objekteigenschaften-Variable „verzeichnis#“ angeben.
Wichtig! Attribute können verschiedene maximale Längen besitzen. Beim Ersetzen der Script-Variablen durch den Wert erfolgt keine Prüfung, ob der gesetzte Wert länger ist als erlaubt. Er wird auf die maximale Länge abgeschnitten.
Mit der Seite „Attribut“, die bei Jobs und Dateiübertragungen zur Verfügung steht, haben Sie die Möglichkeit, bestimmte Attribute erst bei der Aktivierung zu setzen.
Attribute über das Dienstprogramm „AE.DB Change“ ändern
Manche Attribute sind auch mit Hilfe des Dienstprogrammes AE-DB-Change änderbar, siehe AE DB Change.
Beachten Sie, dass eine Besonderheit für Attribute gilt, die als erlaubten Wert „Y“ und „N“ aufweisen. Beide Buchstaben können dem AE DB Change nicht übergeben werden. Verwenden Sie in diesem Fall die Zahl „1“ anstelle von „Y“ und „20“ anstelle von „N“.
Außerdem können dem AE.DB Change keine Abkürzungen übergeben werden. Verwenden Sie daher immer den ausgeschriebenen Namen des Attributes, z.B: „GROUP“ anstelle von „S“.
Das Dienstprogramm ist auch in der Lage, Objektvariablen zu ändern. Hierfür geben Sie den Namen „VALUE“ an, gefolgt von einem Doppelpunkt und dem Namen der Objekteigenschaften-Variable.
Auch die Namen der Ordner lassen sich mit dem AE DB Change ändern. Das anzugebende Attribut heißt in diesem Fall FOLDER_NAME.