WRITE_PROCESS

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

Syntaxe

WRITE_PROCESS (Data-Sequence Reference, File, Agent, Login,[Mode],[CodeTable], [File Attributes], [Column])
WRITE_PROCESS (Data-Sequence Reference, File, Agent, Login,[Mode],[CodeTable], [File Attributes], [ALL], [Delimiter])

Syntaxe	Description / format
Data-Sequence Reference	C'est la référence de la séquence de données dont le contenu doit être exporté dans un fichier. Format : variable de script
File	Chemin et nom du fichier. Format : variable de script ou litéral de script
Agent	Nom de l'agent dont l'hôte doit être utilisé pour stocker le fichier. Format : nom AE, littéral de script ou variable de script
Login	Nom de l'objet Login qui sert pour la connexion à l'hôte de l'agent spécifié. Format : nom AE, littéral de script ou variable de script
Mode	Procédure à suivre lorsque le fichier spécifié existe déjà. Format : nom AE, littéral de script ou variable de script Valeurs autorisées : CANCEL (par défaut) : Le script va être interrompu. OVERWRITE : Le fichier va être écrasé. APPEND : Le fichier existant sera complété avec de nouvelles lignes.
CodeTable	Nom de l'objet Table de codes à utiliser pour encoder le fichier. Format : nom AE, littéral de script ou variable de script Utilise la table de code UC_CODE par défaut si vous ne spécifiez pas ce paramètre.
File Attributes	Attributs de fichier supplémentaires pour le fichier généré. Format : variable de script ou litéral de script Selon le fichier INI de l'agent, vous pouvez spécifier les attributs pouvant être également utilisés pour les transferts de fichiers. Notez que plusieurs attributs doivent être séparés par des virgules.
Column	Colonne(s) de la séquence de données à écrire dans le fichier. Format : littéral de script, variable de script ou nombre sans guillemets Valeurs autorisées : ALL (par défaut) : toutes les colonnes Nombre de colonnes souhaitées (exemple : 2).
Delimiter	Séparateur utilisé lorsque vous définissez plusieurs colonnes. Format : littéral de script, variable de script ou nombre sans guillemets Uniquement pertinent lorsque vous exportez toutes les colonnes de la séquence de données.

Codes retour
0 : fichier exporté avec succès. 20554 : agent actuellement inactif.

Cet élément de script exporte le contenu de n'importe quelle séquence de données dans un fichier texte. Vous devez spécifier une référence pour la séquence de données correpondante qui est conservée lorsque vous créez la séquence de données dans une variable de script.

Chaque ligne de la séquence de données correspond à une ligne dans le fichier.

Vous pouvez définir si toutes les colonnes ou juste certaines colonnes de la séquence de données doivent être écrites dans le fichier. Utilisez le paramètre Column à cet effet. Par défaut, toutes les colonnes sont exportées.

Le paramètre Delimiter n'est pertinent que si vous exportez toutes les colonnes. Ce paramètre vous permet de déterminer le caractère utilisé pour séparer les lignes de la séquence de données dans les colonnes.

Exemples

L'exemple suivant illustre la création d'une séquence de données qui conserve la liste des noms de fichiers d'un certain répertoire. Le contenu de cette séquence de données est ensuite enregistré dans un fichier sur un autre hôte. En cas d'erreur (code retour de WRITE_PROCESS > 0), le système écrit et envoie un message d'erreur à l'utilisateur AE concerné.

:SET &HND# = PREP_PROCESS_FILENAME("WIN01","c:\AUTOMIC\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

Voir aussi :