AE vous permet d'exporter dans un fichier des informations concernant les exécutions de tâches. Sont à votre disposition, par exemple : nom d'objet, statut et code retour. Le rapport de l'exécution est également disponible sous forme de fichier texte. En raison de la structure de ces données, le transfert vers un système de gestion de la sortie peut se faire facilement et simplement.
Vous pouvez accéder aux informations d'exécution, aux rapports de Jobs ainsi qu'aux transferts de fichiers.
Les données de rapport peuvent être préparées dans l'utilitaire AE DB Archive ou en accédant directement à la table de base de données "XRO". Cette dernière possibilité prend en charge vos programmes propriétaires.
Cette forme spéciale de préparation de rapport n'est pas activée par défaut et doit donc être activée pour chaque Client. Pour cela, utilisez la clé XRO_REPORTS de la variable UC_CLIENT_SETTINGS.
Une entrée contenant le nom de l'objet, l'heure de l'exécution et une référence au rapport est écrite pour chaque exécution d'un job ou d'un transfert de fichier. L'utilitaire AE DB Archive vous permet de préparer les données.
N'oubliez pas de supprimer régulièrement les entrées XRO de la table afin d'éviter un accroissement trop important de la taille de la base de données. Le point "Supprimer des entrées de la table" décrit comment réaliser cela.
|
Etablissement d'une liste des rapports |
---|
Démarrez AE DB Archive en mode batch avec la syntaxe suivante, pour obtenir un fichier CSV listant les exécutions de tâches qui n'ont pas encore été archivées :
UCYBDBAR -B -Xlist -Sclient/-Dclient [-Ochemin et nom de fichier] [-Ystatut]
Si vous n'indiquez pas de chemin, un fichier nommé "uc_XROlist.csv" est créé dans le dossier de l'utilitaire.
Le contenu du fichier correspond exactement au contenu de la table de base de données "XRO" dont la structure est décrite à la fin du présent document.
L'utilitaire interrompt le processus si un fichier du même nom existe déjà.
Si le fichier résultat ne doit pas contenir toutes les entrées du tableau, vous pouvez utiliser le paramètre de démarrage _Y. Cela permet de ne sélectionner que les lignes possédant le statut indiqué (colonne "XRO_CusStatus"). Vous pouvez spécifier cette valeur (un nombre) vous-même et la définir lors du déchargement du rapport.
AE DB Archive crée un fichier vide si aucune donnée de rapport n'est disponible.
|
Déchargement des rapports |
---|
Pour exporter un rapport dans un fichier texte, exécutez AE DB Archive en mode batch avec la syntaxe suivante :
UCYBDBAR -B -Xunload -Sclient/-Dclient -RrunID de la tâche [-TYtype de rapport] [-Ochemin et nom de fichier] [-Ystatut]
Spécifiez le RunID de la tâche et le type de rapport pour décharger un rapport particulier. Si vous n'entrez que le RunID, vous obtiendrez tous les rapports de cette exécution.
Si vous n'indiquez pas de chemin, un fichier nommé "uc_XROreport.txt" est créé dans le dossier de l'utilitaire. Le fichier texte contient le contenu du rapport.
L'utilitaire interrompt le processus si un fichier du même nom existe déjà.
Le paramètre de démarrage -Y vous permet de définir un statut pour le rapport. A cette fin, spécifiez un nombre de votre choix qui est entré dans la colonne XRO_CusStatus. Il est possible de filtrer la liste des rapports avec cette valeur.
Lors du déchargement d'un rapport, les entrées qui y figurent ne sont pas supprimées de la table "XRO". Cela se passe dans l'étape suivante.
|
Supprimer les entrées de table |
---|
Vous pouvez réorganiser les entrées de tables de deux façons :
Le fichier CSV exporté contient le contenu et la structure de la table de base de données "XRO". Les deux possèdent donc les colonnes suivantes :
Nom de la colonne |
Description |
---|---|
XRO_Client |
Client |
XRO_AH_Idnr |
Numéro d'exécution (RunID) de la tâche |
XRO_RType |
Type de rapport |
XRO_System |
Nom du système AE |
XRO_OType |
Type d'objet (JobS, JobF) |
XRO_Object |
Nom de l'objet. |
XRO_HostDst |
Nom de l'agent dans l'hôte cible |
XRO_LoginDst |
Nom d'utilisateur sous lequel l'objet est exécuté |
XRO_HostScr |
Nom de l'agent sur l'hôte source (pour les transferts de fichiers seulement) |
XRO_LoginSrc |
Nom d'utilisateur pour l'hôte source (pour les transferts de fichiers seulement) |
XRO_TimeStamp1 |
Heure de début de l'exécution |
XRO_TimeStamp4 |
Heure de fin de l'exécution |
XRO_RetCode |
Code retour de la tâche |
XRO_Status |
Statut de la tâche |
XRO_RRetCode |
Code retour du transfert de rapport "0" - Le rapport a été transmis. |
XRO_ReportSize |
Taille du rapport en octets Notez que les transferts de fichiers contiennent toujours "0" dans cette colonne. |
XRO_UserTime |
Temps utilisateur écoulé |
XRO_KernelTime |
Temps système écoulé |
XRO_CpuTime |
Temps CPU écoulé |
XRO_Archive1 |
Premier Index d'archivage de l'objet |
XRO_Archive2 |
Deuxième Index d'archivage de l'objet |
XRO_CusStatus |
Nombre défini par l'utilisateur pour l'utilisation des filtres |
Rubriques connexes :
Généralités sur les rapports
Paramètres de démarrage