GET_STATISTIC_DETAIL

Utilisez la fonction de script GET_STATISTIC_DETAIL pour extraire un détail des données d'exécution d'un objet. Les listes d'exécution conservent une grande quantité de données sur les objets exécutés. Pour plus d'informations, voir Données d'exécution.

Remarque : Il vous faut l'autorisation (S) d'accès aux données d'exécution de l'objet donné pour exécuter cette fonction de script. Pour plus d'informations, voir Accorder des autorisations Automation Engine.

Syntaxe

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

Paramètres

• GET_STATISTIC_DETAIL
  Extrait les données d'exécution d'un objet
• RunID
  (Optionnel) RunID de l'exécution
  Format : variable de script ou nombre
• Détail
  Informations à extraire des données d'exécution
  Format: Nom AE, littéral de script ou variable de script
• Nom d'objet
  (Optionnel) Nom de l'objet pour lequel les données d'exécution sont extraites
  Format : littéral de script ou variable de script

Codes retour

GET_STATISTIC_DETAIL renvoie un détail de la liste des données d'exécution selon les paramètres spécifiés :

• RunID et Détail (et, optionnellement, le nom d'objet) : renvoie les détails sur l'exécution spécifiée d'un objet particulier
• Détail et Nom d'objet : renvoie les détails sur la dernière exécution de l'objet spécifié
  
• Détail uniquement : renvoie les détails sur les données d'exécution actuelles pour l'objet appelant la fonction de script
  Remarque : Le script ne peut renvoyer les valeurs de certains détails, tels que l'heure d'exécution pour l'exécution actuelle car l'objet est en cours d'exécution.
  

Important ! Le système renvoie les valeurs par défaut suivantes lorsque le détail spécifié n'est pas disponible au moment de l'exécution du script :

• Pour les chaînes de caractères : une chaîne vide
• Pour les nombres : 0
• Pour les horodatages : 0000-00-00 00:00:00

Remarques :

• Ce qui ressemble à une valeur par défaut peut être la valeur actuelle extraite des données d'exécution, telle qu'un code retour de 0.
• La fonction de script renvoie les numéros dans un format à 16 chiffres par défaut, qui inclut les nombres à virgule flottante (type de données : flottant). Les zéros sont insérés aux emplacements non utilisés. Pour plus d'informations, voir Types de données des variable de script.
  Conseil : Utilisez la fonction de script FORMAT pour supprimer les zéros de début ou de fin.
• Le script ne s'interrompt pas lorsque les données d'exécution sont introuvables et que la fonction de script renvoie une chaîne vide.
  Conseil : Utilisez l'instruction de script :ON_ERROR pour définir les actions à entreprendre.

Tous les types d'objets

Les détails de données d'exécution suivants sont disponibles pour tous les types objets exécutables.

Détails généraux

• ACCOUNT
  Compte interne
• ARCHIVE_KEY_1
  Clé d'archivage 1
• ARCHIVE_KEY_2
  Clé d'archivage 2
• ALIAS
  Alias de l'objet exécutable
• NAME
  Nom de l'objet.
• OBJECT_TYPE
  Type d'objet
• USER_ID
  Nom de l'utilisateur (NAME/DEPARTMENT)
• USER_TIME
  Temps utilisateur écoulé

Détails d'activation et d'exécution

• ACTIVATION_TIME
  Heure de l'activation au format AAAA-MM-JJ HH:MM:SS
• CANCEL_FLAG
  Indique si la tâche a été interrompue
  Codes retour :
  • Une chaîne vide
    La tâche n'a pas été interrompue
  • M
    La tâche a été interrompue
• DURATION
  Durée d'exécution en secondes
• END_TIME
  Heure de fin de l'objet au format AAAA-MM-JJ HH:MM:SS
• LAST_ERR_INS
  Message d'erreur de la dernière erreur survenue
• LAST_ERR_NR
  Numéro de la dernière erreur survenue
• LDATE
  Date logique au format AAAA-MM-JJ HH:MM:SS
• MOD_COUNT
  Numéro des modifications de l'objet
• POSTSCRIPT_START_TIME
  Heure de début du post-traitement au format AAAA-MM-JJ HH:MM:SS
• RETURN_CODE
  Code retour
• RUNID
  RunID des données d'exécution sélectionnées
• START_TIME
  Heure de début de l'objet au format AAAA-MM-JJ HH:MM:SS
• STATUS
  Statut de l'exécution
  Pour plus d'informations sur les codes retour du système, voir Codes retour système des objets exécutables.

Reprises

• LAST_RESTART_POINT
  Dernier point de reprise transmis
• REFERENCE_NR
  RunID de référence dans un redémarrage
• RESTART
  Indique si l'exécution est une reprise
  Codes retour :
  • Y
    L'exécution est une reprise
  • N
    L'exécution n'est pas une reprise
• RESTART_POINT
  Point de reprise pour la tâche

Informations sur les tâches parents et les activateurs

• PARENT_ACT
  RunID de l'activateur de la tâche
  Pour plus d'informations : Tâches de niveau supérieur (parents)
• PARENT_PRC
  RunID de la tâche parent lorsque le parent est un processeur (workflow, schedule ou groupe)
• PROCESS_ID
  TSN/ID de processus

Objets événement

Les détails de données d'exécution suivants ne sont disponibles que pour objets Événement.

• CHECK_COUNT
  
  (Objets Événement uniquement) Nombre de vérifications effectuées
• EVENTID
  
  Premier RunID des événements Système de fichier et Console
• OCCURRENCE_COUNT
  Nombre d'événements qui se sont produits

Objets transfert de fichier

Les détails de données d'exécution suivants ne sont disponibles que pour objets Transfert de fichiers.

• COMPRESSION_RATE
  Niveau de compression
  Codes retour :
  • 0
    None
  • 1
    Normal
  • 2
    Fort
  • Une chaîne vide
    Valeur par défaut
• DST_CODE_TABLE
  Nom de la table de codes de destination
• DST_FILE_ATTRIBUTES
  Attributs pour le fichier destination
• DST_FILE_NAME
  Nom du fichier de destination
• DST_HOST
  Nom de l'agent de destination
  
• DST_HOST_TYPE
  Type d'hôte de l'agent de destination
  Codes retour :
• BS2000
• MVS
• NSK
• OS400
• UNIX
• VMS
• WINDOWS
• DST_LOGIN_INFO
  Informations de login complètes sur l'objet Login de destination du transfert de fichier
• DST_LOGIN_NAME
  Nom de l'objet Login de destination
• FILE_SIZE
  Nombre d'octets utilisés par le fichier transféré
• RECORDS
  (Transferts de fichiers texte uniquement) Nombre de lignes ou d'enregistrements transférés
  Remarque : Si le fichier transféré est un fichier binaire, le code retour est 0.
• SRC_CODE_TABLE
  Nom de la table de code source
• SRC_FILE_ATTRIBUTES
  Attributs du fichier source
• SRC_FILE_NAME
  Nom du fichier source
• SRC_HOST
  Nom de l'agent source
• SRC_HOST_TYPE
  Type d'hôte de l'agent source
  Codes retour :
  • BS2000
  • MVS
  • NSK
  • OS400
  • UNIX
  • VMS
  • WINDOWS
• SRC_LOGIN_INFO
  Informations de login complètes sur l'objet Login source du transfert de fichier
• SRC_LOGIN_NAME
  Nom de l'objet Login source
• TRANSFERRED_BYTE_COUNT
  Nombre d'octets transférés

Objets Job

Les détails suivants se réfèrent aux ressources consommées pour l'exécution, et ne sont disponibles qur pour les objets Job.

• CPU_TIME
  Temps CPU écoulé
• IO_COUNT
  Nombre d'E/S
• KERNEL_TIME
  Temps système écoulé

Exemples

L'exemple suivant dans un objet de transfert de fichier lit le nom du fichier à transférer à partir des données d'exécution actuelles.

:SET &SOURCE_FILE# = GET_STATISTIC_DETAIL(,SRC_FILE_NAME)

L'exemple suivant illustre la lecture de l'heure de début de la tâche parent :

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

L'exemple suivant illustre l'extraction de l'heure d'activation d'un objet appelé MM.DAY :

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

L'exemple suivant illustre la lecture et l'impression de l'alias de l'objet exécutable dans le rapport d'activation.

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

:PRINT &ALIAS#

Voir aussi :