PREP_PROCESS_REPORT

Séquences de données

PREP_PROCESS_VAR

---

PREP_PROCESS_REPORTLIST

Fonction de script : Détermine la liste de sorties enregistrées des Jobs déjà effectués et met le résultat à disposition comme liste interne (séquence de données) pour un traitement ultérieur.

Syntaxe

PREP_PROCESS_REPORTLIST([RunID], [Filter])

Commentaires 

Cette fonction de script récupère la liste des résultats de job enregistrés stockés dans l'onglet Répertoire de la boîte de dialogue Rapport. Elle inclut aussi bien les fichiers externes que les rapports standard.

Le code retour de cette fonction de script est la référence d'une séquence de données. Cette dernière peut être transmise en tant que paramètre de démarrage aux instructions de script :PROCESS et :ENDPROCESS, ce qui génère une boucle. Le nombre de cycles de la boucle correspond au nombre d'entrées du résultat de Job. La fonction de script GET_PROCESS_LINE permet d'accéder aux différentes colonnes (huit au total) de chaque ligne.

Aucune nouvelle valeur ne peut être attribuée à la variable de script contenant la référence de la séquence de données. La variable ne peut être réutilisée que si vous supprimez explicitement la séquence de données avec l'instruction de script :CLOSE_PROCESS.

Si le paramètre Filtre n'est pas spécifié, tous les fichiers de résultat de Job sont alors utilisés (correspond à Filtre = *).

Les colonnes suivantes peuvent être lues pour chaque entrée :

Exemple 1

Dans le premier exemple (le plus simple), le nom et le chemin des fichiers de résultat de la dernière exécution du Job JOBS.WIN.OUTPUT sont lus et enregistrés dans le protocole d'activation.

:SET &RUNID# = GET_STATISTIC_DETAIL(,RUNID,JOBS.WIN.OUTPUT)
:SET &HND# = PREP_PROCESS_REPORTLIST(&RUNID#)
:PROCESS &HND#
:SET &FILENAME# = GET_PROCESS_LINE(&HND#, 6)
: IF  &FILENAME# = ""
: ELSE
: PRINT  "File name  = &FILENAME#"
: ENDIF
:ENDPROCESS

Exemple 2

Dans l'exemple ci-dessous, deux fichiers sont générés par un Job Windows et enregistrés comme résultat de Job. Les lignes suivantes se trouvent dans l'onglet Traitement du Job.

dir C:\temp >> C:\temp\test.txt
:REGISTER_OUTPUTFILE "C:\temp\test.txt","N"
dir C:\windows >> C:\temp\test2.txt
:REGISTER_OUTPUTFILE "C:\temp\test2.txt","N"

L'onglet Post-traitement du job contient l'élément de script PREP_PROCESS_REPORTLIST qui demande la liste complète de résultats du job et écrit les différentes colonnes de chaque ligne dans le log du job avec une boucle de traitement. Un transfert de fichier démarre pour chaque fichier de résultat externe et transfère ce fichier vers un ordinateur différent. L'agent, le Login du job et le chemin complet du fichier sont transmis à l'objet transfert de fichier.

:PSET &AGENT_JOB# = GET_ATT(HOST)
:PSET &LOGIN_JOB# = GET_ATT(LOGIN)

:SET &HND# = PREP_PROCESS_REPORTLIST()

:PROCESS &HND#
: SET &RH_TYPE# = GET_PROCESS_LINE(&HND#, 1)
: SET &START_TIME# = GET_PROCESS_LINE(&HND#, 2)
: SET &END_TIME# = GET_PROCESS_LINE(&HND#, 3)
: SET &TITLE# = GET_PROCESS_LINE(&HND#, 4)
: SET &IS_XML# = GET_PROCESS_LINE(&HND#, 5)
: SET &FILENAME# = GET_PROCESS_LINE(&HND#, 6)
: SET &ON_AGENT# = GET_PROCESS_LINE(&HND#, 7)
: SET &IN_DB# = GET_PROCESS_LINE(&HND#, 8)
: PRINT "Report type = &RH_TYPE#"
: PRINT "Start = &START_TIME#"
: PRINT "End = &END_TIME#"
: PRINT "Title = &TITLE#"
: PRINT "XML report? = &IS_XML#"
: PRINT "File name  = &FILENAME#"
: PRINT "On the Agent? = &ON_AGENT#"
: PRINT "In the database? = &IN_DB#"

: IF &FILENAME# = ""
: PRINT "No external output file"
: ELSE
: IF &ON_AGENT# = 1
: PSET &FT_FILE# = &FILENAME#
: SET &AKT# = ACTIVATE_UC_OBJECT(JOBF.OUTPUTHANDLING,,,,,PASS_VALUES,)
: ENDIF
:ENDIF

: PRINT

:ENDPROCESS

Les données du job activé sont maintenant spécifiées comme agent source et Login dans le script de l'objet transfert de fichier. Le chemin et le nom du fichier de résultat de Job externe sont également spécifiés comme fichier source. Le nom du fichier source est repris comme cible et le chemin est remplacé par "C:\output\".

:PUT_ATT FT_SRC_HOST = &AGENT_JOB#
:PUT_ATT FT_SRC_LOGIN = &LOGIN_JOB#
:PUT_ATT FT_SRC_FILE = &FT_FILE#

:SET &POS# = STR_FIND_REVERSE(&FT_FILE#, "\") + 1
:SET &FNAME# = STR_CUT(&FT_FILE#, &POS#)
:SET &DST_FILENAME# = STR_CAT("C:\output\",&FNAME#)

:PUT_ATT FT_DST_FILE = &DST_FILENAME#

Rubriques connexes :

Eléments de script - Séquences de données

Exemples
Définition du statut final en fonction du contenu du rapport
Exécution d'un MBean

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle