Cette fonction permet d'écrire la valeur associée à une section et une clé dans le fichier de données. Si le fichier de données est un fichier paramètre destiné à un programme EXIT, cette fonction contrôle si la section est modifiable, donc si l'écriture est autorisée.
Si Valeur est à blanc, cette fonction supprime la clé dans la section.
Si Clé est à blanc, cette fonction supprime toute la section et donc toutes les clés de la section.
Paramètres
ALPHA(256) |
Fichier |
Nom complet du fichier de données. |
ALPHA(n) |
Section |
Section. |
ALPHA(n) |
Cle |
Clé. |
ALPHA(n) |
Valeur |
Valeur mise à jour dans le fichier. |
NUM_BIN_4 |
CodeRetour |
Code retour d'écriture (mis à jour par la fonction). |
Valeurs possibles du code retour
0 |
Ecriture réussie de Valeur dans le fichier de données. |
Echec lors de l'écriture :
-1 |
Fichier de données non trouvé. |
-2 |
Section invalide : - soit Section est vide, - soit Section est une section élément invalide d'une liste (incompatible avec le nombre d'éléments de la liste), - soit le fichier de données est un fichier paramètre destiné à un programme EXIT et Section ne fait pas partie des sections autorisées. |
-3 |
Clé incompatible avec Section : contrôle exclusivement effectué si le fichier de données est un fichier paramètre destiné à un programme EXIT. |
-20 |
Section non modifiable : contrôle exclusivement effectué si le fichier de données est un fichier paramètre destiné à un programme EXIT. |
-21 |
Valeur non autorisée, ne faisant pas partie des valeurs possibles : contrôle exclusivement effectué si le fichier de données est un fichier paramètre destiné à un programme EXIT. |
-99 |
Une erreur système est apparue à l'écriture dans le fichier de données. |
Exemple
/* Cet exemple correspond à une écriture dans un fichier paramètre
/* destiné à un programme EXIT lors d'une validation de correction
ALPHA(256) |
FicParam |
|
PARAM |
FicParam |
/* paramètre d'appel du programme EXIT |
ALPHA(40) |
Section |
ALPHA(40) |
Cle |
ALPHA(200) |
Valeur |
NUM_BIN_4 |
CodeRetour |
Section = 'PARAM_UTILISATEUR' |
/* section modifiable |
Valeur = 'Valeur transmise de programme EXIT en programme EXIT'
/* écriture de la valeur du paramètre utilisateur dans le fichier paramètre
APPELER_DLL 'PgExTool' 'PgExToolWriteValue' FicParam Section Cle Valeur CodeRetour
Valeur = *BLANK
/* suppression de la valeur du paramètre utilisateur dans le fichier paramètre
APPELER_DLL 'PgExTool' 'PgExToolWriteValue' FicParam Section Cle Valeur CodeRetour
Cliquez ci-dessous pour plus d'informations sur :
les programmes EXIT.