IORRWriteState()

La fonction IORRWriteState() enregistre dans un fichier texte des informations sur l’état courant des variables distantes d’une application. La fonction crée le fichier s’il n’existe pas encore. À chaque exécution du script contenant la fonction, de nouvelles informations sont ajoutées au fichier.

Vous pouvez spécifier quelles informations sur les variables distantes sont enregistrées dans le fichier. La valeur retournée par la fonction indique également le succès de l’ajout des informations au fichier.

Catégorie

Autres

Syntaxe

IORRWriteState(FilePath, Option, " ");

Arguments

FilePath

Chemin complet du fichier texte contenant des informations sur les variables distantes de l’application. L’argument FilePath est une constante chaîne ou une variable de type message.

Option

Variable ou constante de type entier qui spécifie quelles informations du compteur de références distantes est écrit dans le fichier. Les valeurs possibles comprennent :

Chaîne vide « »

Cet argument est réservé pour un usage futur, mais doit être utilisé avec la fonction IORRWriteState() dans un script.

Résultats

Voici quelques exemples pour interpréter les informations enregistrées dans le fichier par un appel à la fonction IORRWriteState().

Liste des adresses courantes

La ligne suivante du fichier de sortie montre un exemple de variable distante active, qu’il est possible de mettre à jour. Cette ligne indique que l’adresse 65535 est associée à la variable distante TestProt:di000 :

65535 <TestProt:di000> (RAA) {C:5/23/2007 9:58:35 AM} {A:5/23/2007 9:58:35 AM}

À la suite du nom de variable de la référence distante figurent trois indicateurs entre parenthèses ou accolades :

• Le premier indicateur, R, informe que la référence distante de la variable a été résolue correctement. Le premier indicateur prend la valeur X si la référence distante de la variable n’est pas encore résolue.

• Le second indicateur informe que la variable distante est active (A) ou inactive (D).

• Le troisième indicateur précise si l’adresse est autorisée (A) ou non autorisée (D) en raison de restrictions de licence.

La date qui suit C correspond à la création de la variable. La date qui suit A correspond à l’activation la plus récente de la variable. La ligne contient, le cas échéant, l’heure de désactivation de la variable distante pendant l’exploitation de l’application InTouch.

La ligne suivante du fichier de sortie montre un exemple de variable distante active, qui dépasse la limite du compteur de variables prévu par la licence InTouch. La référence distante de la variable a été résolue correctement et la variable est actuellement active :

65414 <TestProt:di121> (RAD) {C:5/23/2007 9:58:35 AM} {A:5/23/2007 9:58:35 AM}

Mais aucune mise à jour de la valeur de la variable n’intervient dans l’application InTouch, parce que l’adresse attribuée à la variable distante dépasse la limite du compteur de la licence InTouch.

Liste des adresses actives

La ligne suivante du fichier de sortie montre un exemple de variable distante complètement active, c’est à dire dont les valeurs associées servent à mettre à jour l’application InTouch :

65429 <TestProt:di106> (A) {C:5/23/2007 9:58:35 AM} {A:5/23/2007 9:58:35 AM}

Le premier numéro est le descripteur de la variable distante, suivi de l’adresse, et de l’indicateur A (autorisé) ou D (non autorisé). Les heures de création, de la dernière activation et de la dernière désactivation figurent après les indicateurs dans la ligne de sortie. L’heure de désactivation n’apparaît pas si la variable distante n’a jamais été désactivée pendant l’exploitation de l’application.

La ligne suivante du fichier de sortie montre un exemple de variable distante active, qui dépasse la limite de la licence :

65342 <TestProt:di193> (D) {C:5/23/2007 9:58:35 AM} {A:5/23/2007 9:58:35 AM}

Adresses sous licence

La ligne suivante montre l’adresse associée à la variable distante et à quel moment elle a été ajoutée à la liste.

<testprot:di000> {C:5/23/2007 9:58:36 AM}

Adresses refusées

Des adresses refusées apparaissent dans la liste en raison de limitations dans l’implémentation ou parce que le compteur de variables dépasse le maximum de la licence.

Cet exemple montre une adresse de variable distante, qui dépasse la limite de la licence :

testprot:di125 [1] (L) {F:5/23/2007 9:58:39 AM} {R:5/23/2007 9:58:39 AM}

L’information d’adresse apparaît avec le compteur indiquant le nombre de tentatives réalisées pour référencer l’élément. L’indicateur précise si l’adresse se trouve dans la liste à cause de la licence (L), ou en raison des limitations internes de l’implémentation (I). Les deux horodatages correspondent au premier ajout à la liste, et à l’heure d’accès la plus récente.

Exemple

Cet exemple écrit les adresses de variables distantes actuellement activées dans un fichier situé dans le dossier c:\intouch\data. La variable ReturnValue est renseignée par une valeur entière retournée par la fonction, et indiquant si la fonction a écrit correctement dans le fichier des informations sur les variables distantes.

ReturnValue = IORRWriteState("c:\intouch\data", 2, "");