PC SOFT - Documentation en ligne
Version : 18.0
Communauté : 0 annotation | Annoter Flux RSS
Cette page est également disponible pour : WINDEV Mobile, WINDEV, WEBDEV
Version affichée :
HChangeRepJnl (Fonction)
En anglais : HChangeLogDir

 
WinDev WebDev - Code Serveur WebDev - Code Navigateur WinDev Mobile Etats et Requêtes   Windows Linux Windows Mobile Windows Phone Android Widget Android iPhone/iPad Windows Store apps   Java PHP Ajax Code Utilisateur (MCU) Langage Externe   HyperFileSQL HyperFileSQL Client/Serveur Procédures stockées Hyper File 5.5 OLE DB ODBC Accès Natifs

Modifie l'emplacement des fichiers du journal correspondant à un fichier de données HyperFileSQL (fichier *JNL et fichiers JournalOpération et JournalIdentification si ils existent).

Rappel : Les fichiers JournalOpération et JournalIdentification sont créés uniquement :

  • si la gestion de la réplication est demandée pour le fichier de données.
  • si la gestion du journal sélectionnée correspond au "Journal des écritures et Historique des accès".
Si seul le journal des historiques d'accès est demandé, le fichier *JNL n'est pas créé.

Par défaut, les fichiers physiques correspondant aux journaux sont créés :

  • dans le répertoire spécifié sous l'analyse (option "Description de l'analyse", onglet "Journal/Réplication").

  • dans le répertoire spécifié lors de la description du fichier de données (option "Structure de fichiers .. Description", onglet "Divers"). Cette option est disponible uniquement si le répertoire de l'analyse correspond à "<Répertoire par défaut des fichiers>".

HyperFileSQL Client/Serveur L'emplacement des fichiers du journal ne peut pas être modifié. Cette fonction est ignorée. L'emplacement du journal est configuré dans le fichier HFCONF.INI.

Hyper File 5.5 Cette fonction n'a aucun effet et renvoie toujours Vrai.
 
WinDev WebDev - Code Serveur Windows Linux Ajax HyperFileSQL HyperFileSQL Client/Serveur Hyper File 5.5
// Le fichier "Client" est journalé
HChangeRepJnl(Client, "\\MonServeur\Journal\JNL", "\\MonServeur\Journal\Operation")
...
HAjoute(Client)
// -> le fichier "ClientJNL" est ouvert
// dans le répertoire "\\MonServeur\Journal\JNL"
//-> les fichiers "JournalOpération" et "JournalIdentification"
// sont ouverts dans le répertoire "\\MonServeur\Journal\Operation"
...

<Résultat> = HChangeRepJnl(<Nom du fichier> , <Nouvel emplacement du fichier JNL> [, <Nouvel emplacement du fichier JournalOpération> [, <Emplacement sauvegarde>]])

<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreurInfo permet d'identifier l'erreur.
<Nom du fichier> : Chaîne de caractères (avec guillemets)
Nom logique du fichier de données dont le journal doit être déplacé.
Si ce paramètre est égal à "*", tous les fichiers de données de l'analyse en cours auront leur fichier journal déplacé.
<Nouvel emplacement du fichier JNL> : Chaîne de caractères (avec guillemets)
Nouveau chemin d'accès au fichier JNL associé au fichier journalé (chemin complet ou relatif).
Si ce paramètre correspond à une chaîne vide (""), l'emplacement actuel du fichier n'est pas modifié.
<Nouvel emplacement du fichier JournalOpération> : Chaîne de caractères (avec guillemets) optionnelle
Nouveau chemin d'accès du fichier JournalOpération et du fichier JournalIdentification associé au fichier journalé (chemin complet ou relatif). Le fichier JournalOpération contient toutes les opérations effectuées sur le fichier journalé.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), l'emplacement actuel du fichier n'est pas modifié.
<Emplacement sauvegarde> : Chaîne de caractères (avec guillemets) optionnelle
Chemin des sauvegardes des fichiers journaux. Par défaut, ce chemin correspond à : <répertoire des fichiers JNL>\__JNLBackup

Ce chemin est utilisé lors de la modification automatique des fichiers de données pour archiver les journaux. La fonction HHistoriqueModification recherchera également l'historique des modifications dans ces fichiers.

Si ce paramètre correspond à une chaîne vide (""), l'emplacement actuel n'est pas modifié.

Si ce paramètre correspond à un chemin relatif (et commence par un point), le chemin sera relatif aux fichiers de données.

WinDev WebDev - Code Serveur WinDev Mobile Windows Linux Windows Mobile Ajax HyperFileSQL HyperFileSQL Client/Serveur Hyper File 5.5

Priorité pour la définition de l'emplacement des fichiers du journal

La définition de l'emplacement des fichiers journal se fait selon l'ordre de priorité suivant :

1. Emplacement spécifié lors de la création du fichier journalé (fonction HCréation).

2. Emplacement spécifié par la fonction HChangeRepJnl.

3. Emplacement spécifié dans l'analyse.

4. Emplacement du fichier journalé.

WinDev WebDev - Code Serveur WinDev Mobile Windows Linux Windows Mobile Ajax HyperFileSQL HyperFileSQL Client/Serveur Hyper File 5.5

Le fichier Journal existe lors de l'utilisation de la fonction HChangeRepJnl

Si le fichier Journal existe déjà lors de l'appel à la fonction HChangeRepJnl, ce fichier journal n'est plus utilisé : un fichier journal est créé à l'emplacement spécifié et associé au fichier HyperFileSQL journalé.

Utilisation de la fonction HDéclareExterne avec un fichier journalé : si une application utilise la fonction HDéclareExterne sur un fichier journalé, les modifications effectuées par cette application sont enregistrées dans les fichiers journaux spécifiés dans l'en-tête du fichier HyperFileSQL journalé.

WinDev WebDev - Code Serveur WinDev Mobile Windows Linux Windows Mobile Ajax HyperFileSQL HyperFileSQL Client/Serveur Hyper File 5.5

Divers

  • Si les fichiers sont ouverts lors de la modification du répertoire, les fichiers sont automatiquement fermés.
  • Si le chemin du journal est redéfini plusieurs fois avec la fonction HChangeRepJnl, seul le dernier chemin est utilisé. La modification est effective pour toutes les applications utilisant le fichier journalé.
WinDev WebDev - Code Serveur WinDev Mobile Windows Windows Mobile Ajax HyperFileSQL HyperFileSQL Client/Serveur Hyper File 5.5

Réplication et journalisation

Si la fonction HInitAbonné est utilisée, il est également nécessaire d'initialiser l'emplacement des journaux et des tables d'opérations (fonction HChangeRepJnl, propriétés ..RépertoireJournal, ..RépertoireJournalOpération).

Rappel : La réplication se base sur les journaux et tables d'opérations des fichiers de données. Si l'emplacement des journaux et des tables d'opérations est erroné, la réplication ne peut pas fonctionner.

 
Composantes :
WinDev WebDev - Code Serveur wd180hf.dll
Linux wd180hf.so
Windows Mobile wp180hf.dll
 
 
Version minimum requise : 9
Communauté : 0 annotation Flux RSS
Connectez-vous pour ajouter une annotation | Conditions Générales du service d'annotations