Manuel d'administration > Utilitaires > AE DB Archive > Interface ouverte vers les systèmes de gestion de la sortie

Interface ouverte vers les systèmes de gestion de la sortie

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 :

  1. Lancez AE.DB Archive avec la syntaxe suivante, pour marquer les rapports comme archivés et supprimer leurs entrées de la table de la base de données "XRO":

    UCYBDBAR -B Xmark -S
    client/-Dclient -RrunID de la tâche [-TYtype de rapport]
  2. Utilisez l'utilitaire AE DB Reorg. Si les rapports sont réorganisés, la table XRO est automatiquement incluse dans le processus.

Structure de la table de base de données XRO

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.
"4" - Le rapport est incomplet.
"8" - Le rapport n'a pas é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