:PSET

Das P in :PSET steht für Parent (übergeordnet). Mit der Anweisung :PSET können Sie einer Script-Variablen einen Wert oder das Ergebnis eines arithmetischen Ausdrucks zuweisen und gleichzeitig eine Objektvariable mit demselben Namen für die aktuelle Aufgabe und ihre übergeordnete Aufgabe erstellen oder aktualisieren. Dadurch wird der Wert der Script-Variablen persistent, was bedeutet, dass sie wie jede andere Objektvariable abgerufen werden kann. Im Wesentlichen kombiniert :PSET die Zuweisungsfunktion von :RSET mit der Funktionalität von :PUBLISH (insbesondere unter Verwendung des Gültigkeitsbereichs WORKFLOW).

Mehr Informationen:

• Objektvariablen
• Die Seite "Variablen" definieren
• Ausführen von Objekten: Generierungsphase

Syntax

: PSET Objektvariable = Wert

Parameter

• Objektvariable
  Name der Objektvariablen
  Format: Script-Variable
  Halten Sie die Regeln für Variablennamen ein. Weitere Informationen finden Sie unter Variablennamen.

• value
  Wert, der der Script-Variablen (und der Objektvariablen) zugewiesen wird
  Format: Arithmetischer Ausdruck, Script-Literal, Script-Variable oder Script-Funktion

Verwendung

Sie können die Anweisung :PSET verwenden, um Script-Variablen und ihre Werte als Objektvariablen in der aktuellen und der übergeordneten Aufgabe beizubehalten, damit sie in nachfolgenden Aufgaben verwendet werden können. Dafür müssen Sie Child-Aufgaben in einem Workflow so konfigurieren, dass sie Objektvariablen von der übergeordneten Aufgabe erben. Verwenden Sie in der Objektdefinition der Child-Aufgabe die Einstellung Von Parent erben auf der Seite Variablen. Sie können auch die Option Aufgabe zur Laufzeit generieren in der Objektdefinition einer nachfolgenden Aufgabe festlegen, um erstellte oder aktualisierte Objektvariablen aus vorherigen Aufgaben abzurufen.

Wichtig!

• Beenden Sie den Variablennamen mit einem Trennzeichen, z. B. einem Hash. Dadurch werden Fehler bei der Generierung von Child-Aufgaben vermieden, bei denen die Namen der Objektvariablen und der Workflow-Aufgabe mit denselben Zeichen beginnen.

• Ein Wert einer Script-Variablen, den Sie mit der :PSET-Anweisung setzen, wird niemals an Schedule- oder Periodenobjekte weitergegeben.

Aktivierungsreport

Die :PSET-Anweisung verhält sich wie die :RSET-Anweisung und speichert die Script-Variable und ihre Werte auch im Aktivierungs-Report. Jeder Wert, einschließlich der Werte numerischer Typen wie "signed" oder "float", wird als Text gespeichert.

Die Zeile, die in den Aktivierungsreport geschrieben wird, sieht wie folgt aus:

YYYY-MM-DD HH:MM:SS - U00020206 Variable '&VAR#' wurde mit dem Wert 'VALUE' gespeichert.

Beispiel

Ein Workflow enthält zwei Objekte. Das eine ist ein FileTransfer-Objekt mit dem Namen MM.GET.FILES, das andere ist ein Job mit dem Namen MM.END.PROCESSING. In beiden Objekten ist die Einstellung Aufgabe zur Laufzeit generieren konfiguriert. Angenommen, das FileTransfer-Objekt überprüft die Umgebung, um den entsprechenden Agenten auszuwählen. Wenn der nachfolgende Job ausgeführt wird, verwendet er auch diesen Agenten.

Die folgende Script-Anweisung ändert die Script-Variable &HOST# und ihre entsprechenden Objektvariablen (die eine in der Dateiübertragung und die andere im Workflow) in einen bestimmten Unix-Agenten. Verwenden Sie im Job MM.END.PROCESSING die geerbte Objektvariable &HOST# im Script, um den Agenten auszuwählen, auf dem die Ausführung erfolgen soll:

: PSET    &HOST# = "unix01"

Siehe auch: