GET_STATISTIC_DETAIL

Verwenden Sie die Script-Funktion GET_STATISTIC_DETAIL, um ein Detail aus den Ausführungsdaten eines Objekts abzurufen. Ausführungslisten speichern eine breite Palette von Daten über ausgeführte Objekte. Weitere Informationen finden Sie unter Ausführungsdaten.

Hinweis: Sie benötigen die Berechtigung (S), um auf die Ausführungsdaten des angegebenen Objekts zuzugreifen, damit diese Script-Funktion ausgeführt werden kann. Weitere Informationen finden Sie unter Automation Engine-Berechtigungen gewähren.

Syntax

GET_STATISTIC_DETAIL ([RunID] , Detail [, Object name])

Parameter

• GET_STATISTIC_DETAIL
  Die Ausführungsdaten eines Objektes abrufen.
• RunID
  (Optional) RunID der Ausführung
  Format: Script-Variable oder Zahl
• Detail
  Informationen, die aus den Ausführungsdaten abgerufen werden sollen
  Format: AE-Name, Script-Literal oder Script-Variable
• Object name
  (Optional) Name des Objekts, für das Ausführungsdaten abgerufen werden sollen
  Format: Script-Literal oder Script-Variable

Rückgabewerte

GET_STATISTIC_DETAIL gibt ein Detail aus der Liste der Ausführungsdaten zurück, abhängig von den von Ihnen angegebenen Parametern:

• RunID und Detail (und optional der Objektname): gibt das Detail aus dem angegebenen Lauf eines bestimmten Objekts zurück
• Detail und Objektname: gibt das Detail aus dem letzten Lauf des angegebenen Objekts zurück
  
• Nur Detail: gibt das Detail aus den aktuellen Ausführungsdaten für das Objekt zurück, das die Script-Funktion aufruft
  Hinweis: Das Script kann keine Werte für bestimmte Details wie die Laufzeit für die aktuelle Ausführung zurückgeben, da das Objekt ausgeführt wird.
  

Wichtig! Die folgenden Standardwerte werden zurückgegeben, wenn das angegebene Detail zum Zeitpunkt der Script-Ausführung nicht verfügbar ist:

• Für Zeichenketten: eine leere Zeichenkette
• Für Zahlen: 0
• Für Datums- und Zeitstempel: 0000-00-00 00:00:00

Hinweise:

• Was wie ein Standardwert aussieht, kann der tatsächliche Wert sein, der aus den Ausführungsdaten abgerufen wird, wie beispielsweise ein Rückgabewert von 0.
• Die Script-Funktion gibt standardmäßig Zahlen in einem 16-stelligen Format zurück, einschließlich Gleitkommazahlen (Datentyp: float). Stellen, die nicht verwendet werden, werden mit Nullen aufgefüllt. Weitere Informationen finden Sie unter Datentypen von Script-Variablen.
  Tipp: Verwenden Sie die Script-Funktion FORMAT zum Entfernen von führenden oder endgültigen Nullen.
• Das Script bricht nicht ab, wenn keine Ausführungsdaten gefunden werden und die Script-Funktion eine leere Zeichenkette zurückgibt.
  Tipp: Verwenden Sie die Script-Anweisung :ON_ERROR, um Maßnahmen zu definieren, die im Fehlerfall ergriffen werden sollen.

Alle Objekttypen

Die folgenden Details aus den Ausführungsdaten sind für alle Arten von ausführbaren Objekten verfügbar.

Allgemeine Details

• ACCOUNT
  Interne Kostenstelle
• ARCHIVE_KEY_1
  Archivbegriff 1
• ARCHIVE_KEY_2
  Archivbegriff 2
• ALIAS
  Alias des ausführbaren Objekts
• NAME
  Name des Objektes
• OBJECT_TYPE
  Art des Objekts
• USER_ID
  Name des Benutzers (NAME/DEPARTMENT)
• USER_TIME
  Verbrauchte Benutzerzeit

Aktivierungs- und Ausführungsdetails

• ACTIVATION_TIME
  Zeitpunkt der Aktivierung im Format JJJJJ-MM-TT HH:MM:SS
• CANCEL_FLAG
  Gibt an, ob die Aufgabe storniert wurde
  Rückgabewerte:
  • Eine leere Zeichenkette
    Die Aufgabe wurde nicht storniert
  • M
    Die Aufgabe wurde storniert
• DURATION
  Laufzeit in Sekunden
• END_TIME
  Endzeitpunkt des Objekts im Format JJJJJ-MM-TT HH:MM:SS
• LAST_ERR_INS
  Fehlermeldung des zuletzt aufgetretenen Fehlers
• LAST_ERR_NR
  Fehlernummer des zuletzt aufgetretenen Fehlers
• LDATE
  Logisches Datum im Format JJJJJ-MM-TT HH:MM:SS
• MOD_COUNT
  Anzahl der Modifikationen am Objekt
• POSTSCRIPT_START_TIME
  Startzeitpunkt des Post-Script im Format JJJJJ-MM-TT HH:MM:SS
• RETURN_CODE
  Rückgabewert
• RUNID
  RunID der ausgewählten Ausführungsdaten
• START_TIME
  Startzeitpunkt des Objekts im Format JJJJJ-MM-TT HH:MM:SS
• STATUS
  Status der Ausführung
  Weitere Informationen zu den System-Rückgabewerten finden Sie unter System-Rückgabewerte von ausführbaren Objekten.

Neustarts

• LAST_RESTART_POINT
  Letzter durchlaufener Wiederanlaufpunkt
• REFERENCE_NR
  Referenz-RunID bei einem Neustart
• RESTART
  Gibt an, ob die Ausführung ein Neustart ist
  Rückgabewerte:
  • Y
    Die Ausführung ist ein Neustart
  • N
    Die Ausführung ist kein Neustart
• RESTART_POINT
  Wiederanlaufpunkt für die Aufgabe

Informationen über Parent-Aufgaben und Aktivierer

• PARENT_ACT
  RunID des Aktivierers der Aufgabe
  Mehr Informationen: Übergeordnete Aufgaben (Parent)
• PARENT_PRC
  RunID der Parent-Aufgabe, wenn der Parent ein Prozessor ist (Workflow, Schedule oder Gruppe)
• PROCESS_ID
  TSN/Prozess-ID

Ereignisobjekte

Die folgenden Details aus den Ausführungsdaten sind nur für Ereignisobjekte verfügbar.

• CHECK_COUNT
  
  (nur Ereignisobjekte) Anzahl der durchgeführten Prüfungen
• EVENTID
  
  Erste RunID von Dateisystem- und Konsolenereignissen
• OCCURRENCE_COUNT
  Anzahl der eingetretenen Ereignisse

FileTransfer-Objekte

Die folgenden Details aus den Ausführungsdaten sind nur für FileTransfer-Objekte verfügbar.

• COMPRESSION_RATE
  Komprimierungsstufe
  Rückgabewerte:
  • 0
    Keine
  • 1
    Normal
  • 2
    Stark
  • Eine leere Zeichenkette
    Standardwert
• DST_CODE_TABLE
  Name der Ziel-Code-Tabelle
• DST_FILE_ATTRIBUTES
  Datei-Attribute für die Zieldatei
• DST_FILE_NAME
  Name der Zieldatei
• DST_HOST
  Name des Ziel-Agenten
  
• DST_HOST_TYPE
  Hosttyp des Ziel-Agenten
  Rückgabewerte:
• BS2000
• MVS
• NSK
• OS400
• UNIX
• VMS
• WINDOWS
• DST_LOGIN_INFO
  Vollständige Login-Information des Ziel-Login-Objekts des File Transfers
• DST_LOGIN_NAME
  Name des Ziel-Login-Objekts
• FILE_SIZE
  Anzahl der von der übertragenen Datei verwendeten Bytes
• RECORDS
  (Nur Textdateiübertragungen) Anzahl der übertragenen Zeilen oder Datensätze
  Hinweis: Wenn die übertragene Datei eine Binärdatei ist, ist der Rückgabewert 0.
• SRC_CODE_TABLE
  Name der Quellcode-Tabelle
• SRC_FILE_ATTRIBUTES
  Datei-Attribute der Quelldatei
• SRC_FILE_NAME
  Name des Quelldate
• SRC_HOST
  Name des Quellagenten
• SRC_HOST_TYPE
  Hosttyp des Quellagenten
  Rückgabewerte:
  • BS2000
  • MVS
  • NSK
  • OS400
  • UNIX
  • VMS
  • WINDOWS
• SRC_LOGIN_INFO
  Vollständige Login-Information des Quell-Login-Objekts des File Transfers
• SRC_LOGIN_NAME
  SAP-Mandant des Quell-Login-Objekts
• TRANSFERRED_BYTE_COUNT
  Anzahl der übertragenen Bytes

Jobobjekt

Die folgenden Details beziehen sich auf die verbrauchten Ressourcen für den Lauf und sind nur für Jobobjekte verfügbar.

• CPU_TIME
  Verwendete CPU-Zeit
• IO_COUNT
  Anzahl der I/Os
• KERNEL_TIME
  Verwendete Kernelzeit

Beispiele

Das folgende Beispiel in einem FileTransfer-Objekt liest den Namen der zu übertragenden Datei aus den aktuellen Ausführungsdaten.

:SET &SOURCE_FILE# = GET_STATISTIC_DETAIL(,SRC_FILE_NAME)

Das folgende Beispiel liest die Startzeit der Parent-Aufgabe aus:

:SET &NAME# = SYS_ACT_PARENT_NAME()
 :SET &START# = GET_STATISTIC_DETAIL(,START_TIME, &NAME#)

Das folgende Beispiel ruft die Aktivierungszeit eines Objekts mit dem Namen MM.DAY ab:

:SET &RUNNR# = GET_UC_OBJECT_NR("MM.DAY")
 :SET &ACTIVATION# = GET_STATISTIC_DETAIL(&RUNNR#, ACTIVATION_TIME)

Das folgende Beispiel liest und gibt den Alias des ausführbaren Objekts im Aktivierungsreport aus.

:SET &ALIAS# = GET_STATISTIC_DETAIL(&RUNID#,ALIAS)

:PRINT &ALIAS#

Siehe auch: