Comment utiliser Clipper 5 sous Windows ?

Avant toute installation : ce que Windows peut réellement exécuter

Clipper 5 est un compilateur xBase de l’époque DOS, généralement rencontré dans des versions 5.2 ou 5.3. Il transforme des fichiers source PRG en exécutables DOS, souvent associés à des bases DBF et à des index NTX. Ce n’est ni une application Windows à installer depuis le Microsoft Store, ni un outil de base de données SQL avec interface graphique intégrée. Un Windows 64 bits ne sait pas lancer directement ces exécutables 16 bits. Sur certains anciens Windows 32 bits, la couche NTVDM pouvait parfois les ouvrir, mais ce chemin est absent des éditions 64 bits et ne constitue pas une solution de maintenance fiable.

Réunir les fichiers indispensables sans compromettre la licence ni les données

Partez d’un support ou d’une archive dont vous possédez le droit d’usage : médias d’origine, sauvegarde d’entreprise documentée ou copie remise avec la licence. Les distributions de CA-Clipper ne font plus l’objet d’un téléchargement officiel moderne comparable à un logiciel actuel ; évitez donc les archives anonymes et les exécutables modifiés. Une installation exploitable contient habituellement le compilateur CLIPPER.EXE, un lieur tel que RTLINK.EXE, les répertoires LIB et INCLUDE, ainsi que les bibliothèques éventuellement achetées avec le projet. Gardez ensemble les outils provenant de la même génération de Clipper.

Élément	Exemple de dossier	Rôle	Contrôle à faire
Distribution Clipper	C:\CLP5\CLIPPER5	Compiler et lier	CLIPPER.EXE et RTLINK.EXE présents
Sources du projet	C:\CLP5\WORK	PRG, CH, OBJ, scripts	Copie distincte de l’original
Données de test	C:\CLP5\DATA	DBF, NTX, mémos	Sauvegarde datée avant essai
Émulateur DOS	Windows hôte	Exécuter le 16 bits	Montage du dossier validé
Noms de fichiers	Sans espaces ni accents	Compatibilité DOS	Format 8.3 privilégié

Installer un environnement DOS stable avec DOSBox-X

DOSBox-X est un choix pratique pour faire tourner un environnement DOS sur Windows 64 bits, parce qu’il isole les programmes anciens du système hôte et permet de monter un dossier Windows comme disque DOS. Créez par exemple C:\CLP5, puis placez la distribution dans C:\CLP5\CLIPPER5, les sources dans C:\CLP5\WORK et les données de test dans C:\CLP5\DATA. Évitez un chemin tel que C:\Users\Votre Nom\Documents : les espaces, caractères accentués et chemins profonds compliquent inutilement les outils DOS et les scripts de construction.

1. 1Installez DOSBox-X depuis son canal de distribution reconnu, puis démarrez une première session vide afin de vérifier que la console DOS s’ouvre normalement.
2. 2Créez sur Windows le dossier C:\CLP5 et ses sous-dossiers CLIPPER5, WORK, DATA et TEMP ; attribuez à votre compte le droit de modification sur ces dossiers.
3. 3Montez le répertoire hôte dans l’émulateur avec la commande mount c c:\clp5, puis tapez c: pour travailler sur le disque DOS virtuel.
4. 4Définissez dans la session les chemins de travail : SET PATH=C:\CLIPPER5\BIN;%PATH%, SET INCLUDE=C:\CLIPPER5\INCLUDE, SET LIB=C:\CLIPPER5\LIB et SET TMP=C:\TEMP.
5. 5Ajoutez ces commandes à la section de démarrage automatique de la configuration DOSBox-X seulement après avoir vérifié qu’elles correspondent aux noms réels de vos répertoires.

Compiler et lancer un premier programme Clipper 5

Une fois dans C:\WORK, créez un fichier BONJOUR.PRG avec un éditeur texte qui n’ajoute pas de mise en forme. Son contenu minimal peut être : PROCEDURE Main  ? "Bonjour depuis Clipper 5" RETURN Le compilateur crée normalement BONJOUR.OBJ à partir de BONJOUR.PRG ; le lieur fabrique ensuite BONJOUR.EXE. Les commandes exactes dépendent de la version et du lieur fourni, mais le couple classique livré avec plusieurs éditions est CLIPPER BONJOUR, puis RTLINK FI BONJOUR. Lancez enfin BONJOUR. Si votre kit utilise Blinker ou un autre lieur, reprenez sa syntaxe et son script de construction au lieu de réemployer une commande RTLINK au hasard.

1. 1Vérifiez le répertoire courant avec DIR et assurez-vous que BONJOUR.PRG apparaît sous son nom DOS, sans extension masquée ni caractère inhabituel.
2. 2Compilez avec CLIPPER BONJOUR et contrôlez la création de BONJOUR.OBJ ; une erreur de syntaxe se corrige dans le fichier PRG, puis impose une nouvelle compilation.
3. 3Liez avec RTLINK FI BONJOUR si RTLINK est celui livré avec votre distribution ; contrôlez la présence de BONJOUR.EXE après l’opération.
4. 4Exécutez BONJOUR et vérifiez l’affichage de la ligne attendue avant d’ajouter une base DBF, une bibliothèque tierce ou une impression.
5. 5Créez un fichier BUILD.BAT qui reprend les commandes validées dès que le projet compte plusieurs modules, afin que chaque compilation soit reproductible.

Travailler correctement avec les fichiers DBF et les index NTX

Le modèle Clipper repose sur des fichiers. Une base est souvent un DBF ; les index NTX accélèrent les recherches ; un FPT peut contenir des champs mémo. Un programme qui ouvre CLIENTS.DBF sans l’index correspondant peut sembler fonctionner tout en devenant très lent ou en donnant un ordre de parcours inattendu. Pour un usage partagé, configurez explicitement le mode non exclusif, verrouillez les enregistrements avant une modification et libérez les verrous ensuite. Clipper ne fournit pas, par défaut, les garanties transactionnelles d’un serveur de bases de données moderne : une discipline d’accès reste indispensable.

Besoin	Instruction représentative	Précondition	Point de vigilance
Ouvrir une table	USE CLIENTS NEW	CLIENTS.DBF présent	Fermer ensuite avec USE
Partager des données	SET EXCLUSIVE OFF	Réseau fiable	Verrouiller avant REPLACE
Créer un index	INDEX ON UPPER(NOM) TO CLIENTS	Champ NOM défini	Copie préalable du DBF
Utiliser un index	SET INDEX TO CLIENTS	CLIENTS.NTX présent	Ordre de recherche dépendant
Chercher une clé	SEEK "DUPONT"	Index compatible actif	Normaliser casse et accents

Diagnostiquer les erreurs les plus fréquentes sans multiplier les essais risqués

Traitez les incidents dans l’ordre : compatibilité de l’exécutable, chemin des outils, compilation, liaison, puis données. Modifier simultanément le PATH, les bibliothèques et le code rend le diagnostic impossible. Notez la commande lancée, le message complet et la version des fichiers concernés dans un journal simple. Pour une application existante, copiez aussi les fichiers de configuration, les formats de rapports et les éventuels fichiers d’overlay : l’EXE seul n’est pas toujours suffisant pour reproduire le fonctionnement historique.

Symptôme	Cause probable	Vérification	Correction prudente
EXE refusé par Windows	Programme DOS 16 bits	Windows 64 bits	Lancer dans DOSBox-X
Bad command or file name	PATH incomplet	DIR C:\CLIPPER5\BIN	Corriger PATH et redémarrer
Too many files open	Limite de fichiers trop basse	Valeur CLIPPER et ouvertures	Fermer les tables, ajuster F
Unresolved external	LIB ou OBJ absent	Nom de fonction signalé	Ajouter le module adéquat
Recherche incohérente	Index périmé ou mauvais ordre	Comparer DBF et NTX	Sauvegarder puis reconstruire
Accents illisibles	Jeu de caractères différent	Tester une copie	Documenter et convertir prudemment

Choisir entre maintien contrôlé et migration de l’application

Le maintien sous émulateur convient lorsqu’un nombre limité d’utilisateurs exécute une application stable, hors dépendances web et avec des données bien sauvegardées. Il devient fragile si l’outil doit échanger en temps réel avec des services récents, imprimer sur des pilotes Windows complexes, être déployé sur de nombreux postes ou évoluer régulièrement. Dans ce cas, inventoriez le code et les bibliothèques avant toute réécriture. Harbour constitue une piste fréquente pour préserver une partie de la syntaxe xBase tout en ciblant un environnement actuel, mais les interfaces, bibliothèques graphiques, rapports et particularités de DBF doivent être validés fonction par fonction.

1. 1Inventoriez les exécutables, sources PRG, bibliothèques, fichiers de données, modèles d’impression et périphériques réellement utilisés.
2. 2Constituez un jeu de tests avec des copies anonymisées de données et des résultats attendus pour les calculs, recherches, éditions et exports.
3. 3Décidez de conserver l’émulateur si les tests sont stables et si les besoins métier n’évoluent pas ; documentez alors le poste de référence et sa procédure de restauration.
4. 4Planifiez une migration par modules si l’application reste stratégique, en comparant chaque résultat avec l’ancienne version avant la mise en production.

Ce qu'il faut retenir

La manière la plus sûre d’utiliser Clipper 5 sous Windows consiste à accepter sa nature DOS : isolez-le dans un émulateur, travaillez avec une distribution et des bibliothèques cohérentes, puis testez sur des copies de données. Compilez un programme minimal avant de toucher au projet réel, documentez les commandes qui fonctionnent et protégez les DBF contre les accès concurrents. Si l’application demeure centrale pour votre activité, faites de cet environnement stable une étape de transition, pas une dépendance non maîtrisée.