USE |
Utilise |
|---|---|
| Clipper |
Syntaxe
| USE [filename][INDEX indexfilelist][ALIAS expC] [EXCLUSIVE | SHARED] [NEW] [READONLY] [VIA cDriver]] |
Paramètres
| Nom | Description |
|---|---|
| filename | Ce paramètre permet d'indiquer le nom du fichier de base de données à ouvrir et peut être spécifié sous la forme d'un nom de fichier littéral ou d'une expression de caractère entre parenthèses. |
| INDEX indexfilelist | Ce paramètre permet d'indiquer les noms de 1 à 15 fichiers d'index à ouvrir dans la zone de travail actuelle. Spécifiez chaque index comme nom de fichier littéral ou comme expression de caractère entre parenthèses. Le premier index de la liste devient l'index de contrôle. Si vous spécifiez un indexfilelist en tant qu'expression et que la valeur renvoyée est des espaces ou NIL, elle est ignorée. |
| ALIAS expC | Ce paramètre permet d'indiquer le nom à associer à la zone de travail lorsque le fichier de base de données est ouvert. Vous pouvez spécifier le nom d'alias en tant que nom littéral ou en tant qu'expression de caractère entre parenthèses. Un expC valide peut être n'importe quel identificateur autorisé (c'est-à-dire qu'il doit commencer par un caractère alphabétique et peut contenir des caractères numériques ou alphabétiques et le trait de soulignement). Dans une seule application, le Clipper n'acceptera pas les alias en double. Si cette clause est omise, l'alias prend par défaut le nom du fichier de base de données. |
| EXCLUSIVE | Ce paramètre permet d'ouvrir le fichier de base de données pour une utilisation non partagée dans un environnement réseau. Tous les autres utilisateurs se voient refuser l'accès jusqu'à ce que le fichier de base de données soit CLOSE. |
| SHARED | Ce paramètre permet d'ouvrir le fichier de base de données pour une utilisation partagée dans un environnement réseau. La spécification de cette clause remplace le paramètre EXCLUSIVE actuel. |
| NEW | Ce paramètre permet d'ouvrir filename dans la prochaine zone de travail disponible, ce qui en fait la zone de travail actuelle. Si cette clause n'est pas spécifiée, filename est ouvert dans la zone de travail actuelle. |
| READONLY | Ce paramètre permet d'ouvrir filename avec un attribut en lecture seule. Cette situation vous permet d'ouvrir des fichiers de base de données marqués en lecture seulement. Si vous ne pouvez pas ouvrir la filename de cette façon, une erreur d'exécution est générée. Si cette clause n'est pas spécifiée, filename est ouvert en lecture-écriture. |
| VIA cDriver | Ce paramètre permet d'indiquer le pilote de base de données remplaçable (RDD) avec lequel traiter la zone de travail actuelle. Le paramètre cDriver est le nom du RDD spécifié en tant qu'expression de caractère. Si cDriver est spécifié en tant que valeur littérale, il doit être placé entre guillemets. |
Description
Cette commande permet d'ouvrir la table spécifié, les fichiers d'association de mémo (.DBT) et les fichiers d'index de production (.MDX ou .NDX) si nécessaire.
Remarques
- La commande USE ouvre un fichier de base de données (.dbf) existant, son fichier mémo (.dbt) associé et éventuellement des fichiers d'index (.ntx ou .ndx) associés dans la zone de travail actuelle ou disponible suivante. Dans Clipper, il existe 250 zones de travail avec un maximum de 255 fichiers ouverts dans DOS version 3.3 et supérieur. Avant que la commande USE n'ouvre un fichier de base de données et ses fichiers associés, il ferme tous les fichiers actifs déjà ouverts dans la zone de travail. Lorsqu'un fichier de base de données est ouvert pour la première fois, le pointeur d'enregistrement est positionné sur le premier enregistrement logique du fichier (enregistrement un, si aucun fichier d'index n'est spécifié).
- Dans un environnement réseau, vous pouvez ouvrir des fichiers de base de données comme EXCLUSIVE ou SHARED. L'EXCLUSIVE empêche l'utilisation du fichier de base de données par d'autres utilisateurs jusqu'à la fermeture du fichier. Le SHARED permet à d'autres utilisateurs d'utiliser le fichier de base de données pour un accès simultané. Si le fichier de base de données est SHARED, la responsabilité de l'intégrité des données incombe au programme d'application. Dans Clipper, les fonction FLOCK() et RLOCK() sont les deux moyens de base pour refuser à d'autres utilisateurs l'accès à une zone de travail ou à un enregistrement particulier. Si un USE est spécifié et que ni EXCLUSIVE ni SHARED n'est spécifié, le fichier de base de données est ouvert selon le paramètre EXCLUSIVE actuel. Dans Clipper, toutes les commandes USE doivent spécifier explicitement comment le fichier de base de données doit être ouvert, EXCLUSIVE ou SHARED. Le mode d'ouverture implicite spécifié par SET EXCLUSIVE est fourni à des fins de compatibilité uniquement et n'est pas recommandé.
- L'ouverture d'un fichier de base de données dans un environnement réseau nécessite une manipulation spéciale pour réussir. Tout d'abord, essayez d'utiliser le fichier de base de données sans spécifier la liste INDEX. Ensuite, testez le succès de l'opération à l'aide de NETERR(). Si NETERR() renvoie faux (.F.) alors l'opération d'ouverture a réussi et vous pouvez appliquer SET INDEX TO à la liste d'index. Une utilisation échouera dans un environnement réseau si un autre utilisateur dispose d'un USE EXCLUSIVE du fichier de base de données.
- Vous pouvez ouvrir des fichiers d'index avec USE ou SET INDEX. Le premier index de la liste des index définit l'ordre actuel des enregistrements lors de leur accès. Cet indice est appelé indice de contrôle. Vous pouvez modifier l'index de contrôle actuel sans fermer aucun fichier à l'aide de la commande SET ORDER.
- Pour fermer une base de données et ses fichiers associés dans la zone de travail actuelle, spécifiez USE ou CLOSE sans paramètres. Pour fermer les fichiers de base de données dans toutes les zones de travail, utilisez CLOSE DATABASES. Pour fermer les fichiers d'index dans la zone de travail actuelle sans fermer le fichier de base de données, utilisez CLOSE INDEX ou SET INDEX TO sans paramètres.
- Définition du nombre maximal de fichiers ouverts : le contrôle du nombre de descripteurs de fichiers disponibles pour une application Clipper est contrôlé par une combinaison de la commande FILES du CONFIG.SYS et du paramètre F de la variable d'environnement CLIPPER. Le paramètre F spécifie le nombre maximal de fichiers pouvant être ouverts à tout moment dans le programme Clipper en cours. Le Clipper détermine le nombre de fichiers pouvant être ouverts à l'aide du plus petit des deux paramètres. Par exemple, si la commande FILES est définie sur 120 et le paramètre F sur 50, le nombre maximal de fichiers pouvant être ouverts est de 50. Dans un environnement réseau, les descripteurs de fichiers doivent également être définis dans le fichier de configuration réseau.
- La limite de fichiers est contrôlée par le système d'exploitation. Sous les versions DOS inférieures à 3.3, le nombre maximal de fichiers pouvant être ouverts simultanément est de 20 fichiers. Dans les DOS versions 3.3 et supérieures, la limite maximale est de 255 fichiers.
- Ouverture du même fichier de base de données dans plusieurs zones de travail : bien que l'ouverture d'un fichier de base de données dans plusieurs zones de travail soit possible dans un environnement réseau, cette pratique est fortement déconseillée. Si c'est fait, chaque fichier doit être ouvert avec un alias différent, sinon une erreur d'exécution se produira.
- Ouverture de deux fichiers de base de données avec les mêmes noms, dans des répertoires différents : Bien qu'il soit possible d'ouvrir deux fichiers de base de données avec les mêmes noms dans des répertoires différents, les fichiers de base de données doivent avoir des noms d'alias uniques; sinon, une erreur d'exécution se produira.
Dernière mise à jour : Lundi, le 2 septembre 2013