Objektattribute bearbeiten

Die Attribute eines Objekts können sowohl dauerhaft als auch nur für eine bestimmte Ausführung des Objekts verändert werden.

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-Anweisungen 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	Einbeziehen	Include-Aufruf
  FileTransfer	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 das Kontrollkästchen 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 das Kontrollkästchen 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 anzeigt, die im entsprechenden Include-Objekt definiert wurden. 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.

Attribute dauerhaft ändern

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.

  Siehe Objektattribute bearbeiten

• Bei ausführbaren Objekten können Script-Elemente für den Zugriff auf Attribute verwendet werden.

  Mit der Script-Funktion GET_ATT lesen Sie Attribute, mit :PUT_ATT legen Sie sie fest.

• 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/VARA-Objekte in Objekte und Scripts einfügen).

  Weitere Informationen finden Sie unter Benutzerdefinierte VARA-Objekte.

• Manche Attribute können direkt gesetzt werden, d. h. ohne den Aufruf von :PUT_ATT.

  Tragen Sie hierfür im Objekt in den entsprechenden Feldern eine Script-Variable ein. Vor der Verarbeitung des Objekts wird diese Variable durch den in den Prozess-Seiten definierten Wert oder durch eine Objekteigenschaften-Variable ersetzt.

• Die folgenden Verknüpfungen enthalten Dokumentationsthemen zu objektspezifischen Attributen.

  • Agentengruppen (HOSTG)
  • FileTransfers (JOBF)
  • Benachrichtigung (CALL)
  • Scripts (SCRI)
  • Jobs (JOBS)
  • Remote Task Manager-Objekte definieren
  • Seite "Variablen"
  • Ereignisse (EVNT)
  • Jobgruppen (JOBG)
  • Schedules (JSCH)
  • Workflows (JOBP)

Beispiel

Das Arbeitsverzeichnis eines Windows-Jobs sollte mithilfe der Script-Variablen "&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 FileTransfers 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 Dienstprogramms AE-DB-Change änderbar, siehe AE DB Change.

Eine Ausnahme gilt für Attribute, die die Werte Y und N unterstützen. Diese beiden Buchstaben können dem Dienstprogramm AE DB Change nicht zugewiesen werden.

Tipp: 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 kann auch verwendet werden, um Objektvariablen zu ändern. Hierfür geben Sie den Namen "VALUE" an, gefolgt von einem Doppelpunkt und dem Namen der Objekteigenschaften-Variable.

Tipp: Sie können das Dienstprogramm AE DB Change zum Ändern von Ordnernamen verwenden. Das entsprechende Attribut ist FOLDER_NAME.