GET_PARENT_NR

Verwenden Sie die Script-Funktion GET_PARENT_NR, um die RunID des Prozessors oder Aktivierers einer Aufgabe abzurufen. Die Script-Funktion gibt die Session-ID zurück, wenn die Aufgabe manuell von einem Benutzer aktiviert wird. Die Aufgabe kann jede Art von ausführbarem Objekt sein. Weitere Informationen zu Prozessoren und Aktivierern finden Sie unter Übergeordnete Aufgaben (Parent).

Tipp: Verwenden Sie SYS_ACT_PARENT_NR, um die RunID des Prozessors oder Aktivierers der aktuellen Aufgabe (der Aufgabe, die die Script-Funktion enthält) abzurufen. Weitere Informationen finden Sie unter SYS_ACT_PARENT_NR.

Syntax

GET_PARENT_NR(RunID[, ACT|PRC])

GET_PARENT_NR([ACT|PRC])

Parameter

• GET_PARENT_NR
  Liefert die RunID des Aktivierers oder Prozessors oder die Session-ID, wenn die Aufgabe von einem Benutzer aktiviert wird

• RunID
  (Optional) RunID der aktivierten Aufgabe
  Format: Script-Literal oder Script-Variable
  Hinweis: Wenn keine RunID angegeben wird, gibt die Script-Funktion den übergeordneten Teil der Aufgabe zurück, den das Script enthält.

• ACT oder PRC
  (Optional) Gibt die Art der Aktivierung an
  Erlaubte Werte:

  • ACT
    Aktivierer
    Parent-Aufgabe, die die Child-Aufgabe aktiviert, oder Benutzer, der die Aufgabe manuell aktiviert
  • PRC
    Prozessor (Standard)
    Andere Möglichkeiten, die Aufgabe zu aktivieren
  Hinweis: Wenn kein Aktivierungstyp angegeben wird, ermittelt die Script-Funktion den Processor (Standard).

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• RunID des Aktivierers oder Prozessors
• Session-ID
  (nur ACT) Aufgabe wurde manuell von einem Benutzer aktiviert
  Weitere Informationen finden Sie unter Letzte Sitzung unter Benutzer (USER).
• Leerer Wert
  Es existiert keine Parent-Aufgabe

Beispiel

Das folgende Script ruft die RunID einer Aufgabe ab und verwendet sie, um Informationen über den Aktivierer der Aufgabe zurückzugeben.

:SET &RunID# = GET_UC_OBJECT_NR(MAWI.END.PROCESSING)
:SET &RET# = GET_PARENT_NR(&RunID#, ACT)
:PRINT "The task was activated by &RET#"

Wenn die Aufgabe durch eine Parent-Aufgabe wie z.B. einen Workflow aktiviert wurde, würde die Ausgabe im Aktivierungsreport wie folgt aussehen:

2018-11-06 15:26:01 - U00020408 The task was activated by 0001004059

Wenn ein Benutzer die Aufgabe manuell ausführt, zeigt die Ausgabe die Session-ID des Benutzers an:

2018-11-06 15:26:01 - U00020408 The task was activated by 0001000081

Siehe auch: