|
GET_PUBLISHED_VALUE |
Lecture ou modification d'objets |
GET_SYNC |
|
| Fonction script : Détermine les détails à partir d'un enregistrement statistique d'un objet activable. |
GET_STATISTIC_DETAIL([RunID] , Detail [, nom d'objet])
|
Elément de syntaxe |
Description/format |
|---|---|
|
RunID |
Numéro courant de l'exécution (RunID) à 10 caractères |
|
Détail |
Information qui doit être déterminée à partir de l'enregistrement statistique. Vous trouverez, dans les remarques, un tableau récapitulant les valeurs autorisées. |
|
Nom d'objet |
Nom de l'objet dont l'enregistrement statistique doit être lu. |
|
Code retour |
|---|
|
Détail issu d'un enregistrement statistique |
Attention : Les Utilisateurs doivent utiliser l' Autorisation "S" pour chaque objet, afin de pouvoir exécuter cette fonction script.
La fonction script peut être utilisée dans les configurations suivantes :
Formulez la fonction script avec précaution. Pour les valeurs qui ne peuvent pas encore être déterminées au moment de l'exécution du script, les valeurs par défaut suivantes sont renvoyées :
Il peut, toutefois, également s'agir de valeurs issues des détails statistiques lus (par exemple: Code retour 0) !
Si aucun enregistrement statistique n'est trouvé, la fonction script renvoie une chaîne vide. Cela ne provoque pas l'interruption du script ! L'erreur peut cependant être interceptée avec le script :ON_ERROR.
Le deuxième paramètre nécessite l'indication du détail statistique à lire. Le tableau suivant vous indique quelles valeurs peuvent être déterminées :
|
Détail |
Description |
|---|---|
|
ACCOUNT |
Compte interne |
|
ACTIVATION_TIME |
Date et heure de l'activation au format "AAAA-MM-JJ HH:MM:SS" |
|
ARCHIVE_KEY_1 |
Index d'archivage 1 |
|
ARCHIVE_KEY_2 |
Index d'archivage 2 |
|
CANCEL_FLAG |
Interruption de la Tâche Codes retour : |
|
CHECK_COUNT |
Nombre de vérifications de l'objet Evènement |
|
COMPRESSION_RATE |
Niveau de compression Codes retour : |
|
CPU_TIME |
Temps CPU utilisé |
|
DST_CODE_TABLE |
Nom de la Table de Codes cible pour les Transferts de Fichiers |
|
DST_FILE_ATTRIBUTES |
Attributs du fichier cible pour les Transferts de Fichiers |
|
DST_FILE_NAME |
Nom du fichier cible pour les Transferts de Fichiers |
|
DST_HOST |
Nom de l'Agent cible pour les Transferts de Fichiers et les Jobs |
|
DST_HOST_TYPE |
Type d'hôte de l'Agent cible pour les Transferts de Fichiers Codes retour : |
|
DST_LOGIN_INFO |
Ensemble des infos de connexion de l'objet Login cible du Transfert de Fichier |
|
DST_LOGIN_NAME |
Nom de l'objet Login cible |
|
DURATION |
Durée d'exécution en secondes |
|
END_TIME |
Heure de fin de l'objet au format "AAAA-MM-JJ HH:MM:SS" |
| EVENTID | Premier RunID des Evènements de systèmes de fichiers ou de console |
|
FILE_SIZE |
Nombre d'octets du fichier transféré |
|
IO_COUNT |
Nombre d'entrées/de sorties |
|
KERNEL_TIME |
Temps système utilisé |
|
LAST_ERR_INS |
Insertion de message |
|
LAST_ERR_NR |
Numéro de la dernière erreur qui s'est produite |
|
LAST_RESTART_POINT |
Dernier point de reprise exécuté |
|
LDATE |
Date logique au format "AAAA-MM-JJ HH:MM:SS" |
|
MOD_COUNT |
Nombre de modifications apportées à l'objet |
|
NAME |
Nom de l'objet |
|
OBJECT_TYPE |
Type d'objet |
|
OCCURENCE_COUNT |
Nombre d'Evènements survenus (pour les objets Evènement) |
|
PARENT_ACT |
RunID de la Tâche parent (activator) |
|
PARENT_PRC |
RunID de la Tâche parent (processor) |
|
POSTSCRIPT_START_TIME |
Heure de début du post traitement au format "AAAA-MM-JJ HH:MM:SS" |
|
PROCESS_ID |
N° TSN/processus |
|
RECORDS |
Transferts de fichiers texte : nombre de lignes ou d'enregistrements transférés. |
|
REFERENCE_NR |
RunID de référence pour la reprise |
|
RESTART |
Reprise Codes retour : |
|
RESTART_POINT |
Point de reprise à partir duquel la Tâche est démarrée |
|
RETURN_CODE |
Code retour |
| RUNID | RunID de l'enregistrement statistique sélectionné |
|
SRC_CODE_TABLE |
Nom de la Table de Codes source pour les Transferts de Fichiers |
|
SRC_FILE_ATTRIBUTE |
Attributs du fichier source pour les Transferts de Fichiers |
|
SRC_FILE_NAME |
Nom du fichier source pour les Transferts de Fichiers |
|
SRC_HOST |
Nom de l'Agent source pour les Transferts de Fichiers |
|
SRC_HOST_TYPE |
Type d'hôte de l'Agent source pour les Transferts de Fichiers Codes retour : |
|
SRC_LOGIN_INFO |
Ensemble des infos de connexion de l'objet Login source du Transfert de Fichier |
|
SRC_LOGIN_NAME |
Nom de l'objet Login source |
|
START_TIME |
Heure de début de l'objet au format "AAAA-MM-JJ HH:MM:SS" |
|
STATUS |
Statut (code retour système) de l'exécution (par exemple, "1850") |
|
TRANSFERRED_BYTE_COUNT |
Nombre d'octets transférés |
|
USER_ID |
Nom d'utilisateur au format "NOM/DEPARTEMENT" |
|
USER_TIME |
Temps utilisateur utilisé |
La ligne suivante est utilisée dans un objet Transfert de Fichier. Elle lit le nom du fichier à transférer dans l'exécution actuelle.
:SET &FICHIERSOURCE# = GET_STATISTIC_DETAIL(,SRC_FILE_NAME)
Dans ce deuxième exemple, c'est l'heure de début de la Tâche parent qui est lue.
:SET &NOM# = SYS_ACT_PARENT_NAME()
:SET &DEBUT# = GET_STATISTIC_DETAIL(,START_TIME,&NOM#)
Dans cet exemple, la fonction script détermine l'heure d'activation de l'objet GS.JOUR.
:SET &NUMRUN# = GET_UC_OBJECT_NR("GS.JOUR")
:SET &ACTIVATION# = GET_STATISTIC_DETAIL(&NUMRUN#, ACTIVATION_TIME)
Rubriques connexes :
Elément de script - Lecture ou modification d'objets
Généralités sur les scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle