GET_PARENT_NR

Verwenden Sie die Script-Funktion GET_PARENT_NR, um die RunID des Verarbeiters 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 Verarbeitern und Aktivierern finden Sie unter Übergeordnete Aufgaben (Parent).

Tipp:Verwenden Sie SYS_ACT_PARENT_NR, um die RunID des Verarbeiters 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 Verarbeiters 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 Sie keine RunID angeben, gibt die Script-Funktion die Parent-Aufgabe der Aufgabe zurück, die das Script enthält.

• ACT oder PRC
  (Optional) Gibt den Typ der Aktivierung an
  Zulässige Werte:

  • ACT
    Aktivierer
    Parent-Aufgabe, die die angegebene Child-Aufgabe aktiviert, oder Benutzer, der die Aufgabe manuell aktiviert
  • PRC
    Verarbeiter (Standard)
    Anderes Mittel, die Aufgabe zu aktivieren
  Hinweis: Wenn kein Aktivierungstyp angegeben wird, ermittelt die Script-Funktion den Verarbeiter (Standard).

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

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

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 "Die Aufgabe wurde aktiviert von &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 Die Aufgabe wurde aktiviert von 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 Die Aufgabe wurde aktiviert von 0001000081

Siehe auch: