Manuel des Scripts Automation Engine > Organisation fonctionnelle > Séquences de données > WRITE_PROCESS

WRITE_PROCESS

Fonction script : Ecrit le contenu d'une séquence de données dans un fichier.

Syntaxe

WRITE_PROCESS(Référence de la séquence de données, Fichier, Agent, Login [,[Mode] [,[Table de Code] [,[Attributs de fichier] [,Colonne]]]])
WRITE_PROCESS(Référence de la séquence de données, Fichier, Agent, Login [,[Mode] [,[Table de Code] [,[Attributs de fichier] [,ALL [,Délimiteur]]]]])

Elément de syntaxe	Description/format
Référence Séquence de données	Référence à la séquence de données dont le contenu doit être exporté dans un fichier. Format : Variable de script
Fichier	Chemin et nom du fichier Format : Variable de script ou littéral de script
Agent	Nom de l'Agent dont l'hôte contient l'enregistrement du fichier. Format : Nom AE, Variable de script ou Variable de script
Login	Nom de l'objet Login qui est utilisé pour l'identification sur l'hôte de l'Agent indiqué. Format : Nom AE, Variable de script ou Variable de script
Mode	Comportement si le fichier indiqué existe déjà. Format : Nom AE, Variable de script ou Variable de script Valeurs autorisées : CANCEL Interrompre l'exécution du script (valeur par défaut) OVERWRITE - Réécrire le fichier APPEND - Ajouter de nouvelles lignes au fichier existant
Table de Codes	Nom d'un objet Table de Code devant être utilisé pour le codage du fichier. Format : nom AE, Variable de script ou Variable de script Si ce paramètre n'est pas indiqué, la table de Code standard UC_CODE est utilisée.
Attributs de fichier	Attributs de fichier supplémentaires pour le fichier créé Format : Variable de script ou litéral de script En fonction de la plateforme de l'Agent, vous pouvez indiquer les attributs pouvant également être spécifiés pour les Transferts de Fichier. Si vous indiquez plusieurs attributs, vous devez les séparer par des virgules.
Colonne	Colonne(s) de la séquence de données devant être écrite(s) dans le fichier. Format : littéral de script, Variable de script, nombre sans guillemets Valeurs autorisées : ALL (valeur par défaut) - Toutes les colonnes Numéro de la colonne correspondante (p. ex. : 2)
Délimiteur	Séparateur en cas d'indication de plusieurs colonnes Format : littéral de script, Variable de script, nombre sans guillemets Important uniquement si toutes les colonnes de la séquence de données sont exportées.

Code retour
0 - Exportation du fichier réussie 20554 - Agent actuellement non actif

Remarques

L'élément de script exporte le contenu d'une séquence de données au choix dans un fichier texte. La référence à la séquence de données correspondante qui est enregistrée dans une Variable de script lors de la création d'une séquence de données doit alors être indiquée.

Chaque ligne de la séquence de données est écrite dans le fichier sous forme de ligne.

Il est possible d'écrire dans le fichier soit toutes les colonnes, soit une colonne spécifique de la séquence de données. Cela doit être défini dans le paramètre Colonne ; par défaut, toutes les colonnes sont néanmoins exportées.

Le paramètre Délimiteur est uniquement important si toutes les colonnes sont exportées. Il définit le caractère permettant de séparer les lignes de la séquence de données dans des colonnes.

Exemples

L'exemple suivant crée une nouvelle séquence de données qui enregistre une liste avec des noms de fichier d'un répertoire spécifique. Le contenu de cette séquence de données est ensuite enregistré dans un fichier sur un autre hôte. Si une erreur se produit (code Retour de WRITE_PROCESS > 0), un message d'erreur est généré et envoyé à l'utilisateur AE concerné.

:SET &HND# = PREP_PROCESS_FILENAME("WIN01","c:\ae\server\bin\*.exe",,,,"COL=DELIMITER","DELIMITER=*\*")
:SET &RET# = WRITE_PROCESS(&HND#,"C:\temp\export.txt",WIN02, LOGIN.GLOBAL,OVERWRITE)

:IF &RET# > 0
: SET &ERRNR# = SYS_LAST_ERR_NR()
: SET &ERRINS# = SYS_LAST_ERR_INS()
: SET &MESSAGE# = GET_MSG_TXT(&ERRNR#,&ERRINS#)
: SEND_MSG &$USER#, &$DEPARTMENT#, &MESSAGE#
:ENDIF

Rubriques connexes :

Elément de script	Description
CREATE_PROCESS	Crée une nouvelle séquence de données.
GET_PROCESS_LINE	Détermine le contenu actuel des lignes d'une séquence de données.
LOAD_PROCESS	Charge une séquence de données enregistrée.
PREP_PROCESS	Exécute avec l'aide d'objets Job spécifiques (Jobs d'Evènement) des commandes sur un ordinateur et fournit la sortie de console comme liste interne (séquence de données) qui peut être utilisée pour des traitements ultérieurs.

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

Généralités sur les scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle