Débranche temporairement l'accès distant pour accéder à des fichiers de données HFSQL Classic présents en local. Par défaut, l'accès distant est automatiquement géré dès l'ouverture d'une analyse distante avec la fonction
HOuvreAnalyse.
Attention : L'usage de cette fonction est réservé aux programmeurs expérimentés. La fonction HGèreAccèsDistant ne concerne que les fichiers de données HFSQL.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
// Ouverture d'une analyse distante
HOuvreAnalyse("ANADIST.WDD", "", "192.32.8.10", "MonLogin", "MotPasse")
// Ouverture d'un fichier distant
HOuvre("MONFICDIST")
// ...
HGèreAccèsDistant(Faux) // Ordres HFSQL suivants seront effectués en local
HOuvre("MONFICLOC") // Ouverture d'un fichier local
// ...
HGèreAccèsDistant(Vrai) // Ordres HFSQL suivants seront exécutés en distant
// ...
HFermeAnalyse()
HGèreAccèsDistant(Vrai) // Ordres HFSQL suivants seront effectués en distant
HOuvre(Client) // Ouverture d'un fichier distant
//...
HGèreAccèsDistant(Commande, Faux) // Fichier Commande passe en local
HLitPremier(Client) // Lit le premier enregistrement en distant
HLitPremier(Commande) // Lit le premier enregistrement en local
Syntaxe
HGèreAccèsDistant(<Ancien mode> [, <Nom du fichier>] , <Mode de gestion>)
<Ancien mode> : Booléen
- Vrai si l'accès distant était géré avant l'utilisation de la fonction HGèreAccèsDistant,
- Faux si l'accès distant n'était pas géré avant l'utilisation de la fonction HGèreAccèsDistant.
<Nom du fichier> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom du fichier de données manipulé. Permet de brancher ou non la gestion de l'accès distant sur un seul fichier de données.
Si ce paramètre n'est pas spécifié ou correspond à "*", la gestion de l'accès distant est prise en compte pour tous les fichiers de données de l'analyse.
<Mode de gestion> : Booléen
- Faux pour débrancher temporairement la gestion de l'accès distant,
- Vrai pour rebrancher la gestion de l'accès distant.
Remarques
Fermeture des fichiers de données
Le débranchement temporaire de la gestion de l'accès distant ne ferme pas les fichiers de données utilisés, en local ou à distance.
Exemple de manipulation de fichiers de données installés en local et à distance
- Ouverture d'une analyse distante avec la fonction HOuvreAnalyse. La gestion de l'accès distant est activée.
- Ouverture du fichier de données distant FicRPC avec la fonction HOuvre.
- Parcours du fichier de données distant FicRPC.
- Débranchement temporaire de l'accès distant avec la fonction HGèreAccèsDistant.
- Ouverture du fichier de données local FicLocal avec la fonction HOuvre.
- Parcours du fichier de données local FicLocal.
- Rebranchement de l'accès distant avec la fonction HGèreAccèsDistant.
- Les fichiers de données suivants sont accessibles :
- Fichier local FicLocal,
- Fichier distant FicRPC.