Les erreurs

Toutes les nouvelles fonctions MSX-DOS 2 (code de fonction supérieur à 40h) renvoient un code d'erreur dans le registre A. Si la valeur est zéro alors l'opération a réussi. Si la valeur est différent de zéro, alors le code d'erreur explique la nature exacte de l'erreur.

Étant donné que MSX-DOS 2 exécute une instruction "OR A" immédiatement avant de revenir d'un appel de fonction, l'instruction "JR NZ" est souvent utilisée dans le programme transitoire immédiatement après l'instruction "CALL 5" pour tester si une erreur s'est produite. Souvent, la destination de ce saut d'erreur charge simplement le code d'erreur dans B et exécute une fonction "Terminer avec le code d'erreur". Celui-ci transmet ensuite le code d'erreur à l'interpréteur de commandes affichant le message approprié.

Un programme transitoire peut également lui-même obtenir le message réel pour toute erreur renvoyée par un appel de fonction MSX-DOS 2 à l'aide de la fonction "Expliquer le code d'erreur".

Les codes d'erreur commencent à 0FFh et descendent en valeur. Les valeurs inférieures à 40h sont des erreurs de l'utilisateur et ne seront jamais utilisées par le système et peuvent être utilisées par des programmes transitoires pour renvoyer leurs propres erreurs. Les erreurs utilisateur inférieures à 20h renvoyées à l'interpréteur de commandes n'afficheront aucun message.

Si l'appel de la fonction "Expliquer le code d'erreur" est invité à expliquer un code d'erreur pour lequel il n'a pas de message, alors la chaîne de caractères renvoyée sera "System error n" ou "User error n" selon le cas, où n est le numéro d'erreur.

Vous trouverez ci-dessous une liste de tous les numéros d'erreur actuellement définis, ainsi que leurs messages et leurs significations. Le mnémonique est également indiqué, étant souvent utilisé comme symbole dans un fichier source et est utilisé dans tout le système MSX-DOS 2 pour faire référence à une erreur particulière.

Erreurs disques

Les erreurs de ce groupe sont celles étant généralement transmises aux routines de gestion des erreurs de disque. Par défaut, elles seront signalées comme des erreurs «Abort, Retry». Ces erreurs, à l'exception de celle de «format disk», seront transmises à la routine de gestion des erreurs, elles ne seront donc pas renvoyées comme valeur de retour par BDOS.

Le disque n'est pas accessible dans cette unité de disque (par exemple, un disque double face dans un unité de disque simple face).

Une erreur générale s'est produite lors d'une écriture sur disque.

Une erreur de disque générale inconnue s'est produite.

L'unité de disque n'a pas répondu, cela signifie généralement qu'il n'y a pas de disque dans l'unité de disque.

Avec VERIFY activé, un secteur ne pouvait pas être lu correctement après avoir été écrit.

Un secteur de disque n'a pas pu être lu car la vérification des erreurs CRC était incorrecte, indiquant généralement un disque endommagé.

Le secteur requis est introuvable sur le disque, ce qui signifie généralement un disque endommagé.

Essayez d'écrire sur un disque avec l'onglet de protection en écriture activé.

Le disque n'a pas été formaté ou il s'agit d'un disque utilisant une technique d'enregistrement différente.

Le disque est formaté pour un autre système d'exploitation et n'est pas accessible par MSX-DOS.

Le disque a été changé pendant que MSX-DOS y accédait. Doit remplacer le bon disque.

Le disque a été changé alors qu'il y a un fichier ouvert dessus. Doit remplacer le bon disque.

La piste requise du disque est introuvable.

La table d'allocation de fichiers sur le disque est corrompue. CHKDSK peut être en mesure de récupérer certaines des données sur le disque.

Cette erreur n'a pas de message car elle est toujours interceptée en interne dans MSX-DOS dans le cadre de la gestion des modifications de disque.

Essayez de formater un unité de disque ne permettant pas le formatage. Généralement à la suite d'une tentative de formatage du disque RAM.

Erreurs de fonction MSX-DOS

Les erreurs suivantes sont celles étant normalement renvoyées par les appels de fonction MSX-DOS.

Ne devrait jamais se produire.

Le MSX-DOS a manqué de mémoire dans son segment de données de noyau 16 Ko. Essayez de réduire le nombre de tampons de secteur ou de supprimer certaines chaînes de caractères d'environnement. Se produit également s'il n'y a pas de segments libres pour créer le RAMdisk.

Un appel MSX-DOS a été effectué avec un numéro de fonction non autorisé. La plupart des appels de fonction illégaux ne renvoient aucune erreur, mais cette erreur peut être renvoyée si un appel de fonction "obtenir le code d'erreur précédent" est effectué.

Un paramètre de numéro de l'unité de disque ou une lettre de l'unité de disque dans une chaîne de caractères de l'unité de disque/chemin/fichier est un paramètre n'existant pas dans le système actuel.

Une chaîne de caractères de nom de fichier est illégale. Ceci n'est généré que pour les chaînes de caractères de noms de fichiers purs, et non pour les chaînes de caractères de l'unité de disque/chemin/fichier.

Peut être renvoyé par n'importe quel appel de fonction recevant une chaîne de caractères de l'unité de disque/chemin/fichier ASCIIZ. Indique que la syntaxe de la chaîne de caractères est incorrecte d'une manière ou d'une autre.

Peut être renvoyé par n'importe quel appel de fonction qui reçoit une chaîne de caractères de l'unité de disque/chemin/fichier ASCIIZ. Indique que le chemin complet spécifié (y compris le répertoire actuel s'il est utilisé) comporte plus de 63 caractères.

Peut être retourné par n'importe quelle fonction recherchant des fichiers sur un disque si elle n'en trouve pas. Cette erreur est également renvoyée si un répertoire a été spécifié mais introuvable. Dans d'autres cas, l'erreur .NODIR sera renvoyée.

Renvoyé si un élément de répertoire dans une chaîne de caractères de l'unité de disque/chemin/fichier est introuvable.

Renvoyé par "création" ou "déplacement" si une nouvelle entrée est requise dans le répertoire racine et qu'il est déjà plein. Le répertoire racine ne peut pas être étendu.

Résulte généralement d'une opération d'écriture s'il n'y avait pas suffisamment d'espace sur le disque pour la quantité de données en cours d'écriture. Peut également résulter d'une tentative de création ou d'extension d'un sous-répertoire si le disque est complètement plein.

C'est le résultat de "renommer" ou "déplacer" si le nom du fichier de destination existe déjà dans le répertoire de destination.

Résulte d'une tentative de déplacement d'un sous-répertoire dans l'un de ses propres descendants. Ceci n'est pas autorisé car cela créerait une boucle isolée dans la structure des répertoires.

Tentative d'écriture ou de suppression d'un fichier dont le bit d'attribut de "lecture seulement" est défini.

Tentative de suppression d'un sous-répertoire n'étant pas vide.

Peut résulter d'une tentative de modification des attributs d'un fichier de manière illégale, ou d'une tentative d'effectuer une opération sur un fichier n'étant possible que sur un sous-répertoire. Résulte également de l'utilisation illégale de blocs d'informations de nom de volume.

Tenter d'effectuer une opération illégale sur le "." ou ".." entrées dans un sous-répertoire, comme les renommer ou les déplacer.

Essayez de créer un fichier ou un sous-répertoire portant le même nom qu'un fichier système existant. Les fichiers système ne sont pas automatiquement supprimés.

Essayez de créer un fichier ou un sous-répertoire identique à un sous-répertoire existant. Les sous-répertoires ne sont pas automatiquement supprimés.

Essayez de créer un sous-répertoire du même nom qu'un fichier existant. Les fichiers ne sont pas automatiquement supprimés lors de la création de sous-répertoires.

Tentative de suppression, de renommage, de déplacement ou de modification des attributs ou de la date et de l'heure d'un fichier pour lequel un descripteur de fichier est déjà ouvert, autrement qu'en utilisant le descripteur de fichier lui-même.

La zone de transfert de disque aurait dépassé 0FFFFh.

La chaîne de l'unité d'allocation d'un fichier était corrompue. Utilisez CHKDSK pour récupérer autant de fichiers que possible.

Tentative de lecture à partir d'un fichier lorsque le pointeur de fichier est déjà à ou au-delà de la fin du fichier.

Tentative de lecture ou d'écriture dans un descripteur de fichier ayant été ouvert avec l'ensemble de bits d'accès approprié. Certains des descripteurs de fichiers standard sont ouverts en mode lecture seulement ou écriture seulement.

Le numéro d'identification de processus transmis à la fonction "joindre" n'est pas valide.

Essayez d'ouvrir ou de créer un descripteur de fichier alors que tous les descripteurs de fichier sont déjà utilisés. Il existe 64 descripteurs de fichiers disponibles dans la version actuelle.

Le descripteur de fichier spécifié est supérieur au numéro de descripteur de fichier maximal autorisé.

Le descripteur de fichier spécifié n'est pas ouvert actuellement.

Tentative d'utilisation d'un gestionnaire de fichier de périphérique ou d'un bloc d'informations de fichier pour une opération non valide telle que la recherche ou le déplacement.

La chaîne du nom de l'élément d'environnement contient un caractère non valide.

Le nom de l'élément d'environnement ou la chaîne de caractères de valeur est soit plus long que la longueur maximale autorisée de 255, soit trop long pour le tampon de l'utilisateur.

Les paramètres de date passés à "set date" ne sont pas valides.

Les paramètres de l'heure passés à "set time" ne sont pas valides.

Renvoyé par la fonction "ramdisk" si vous essayez de créer un disque RAM alors qu'il en existe déjà un.

Essayez de supprimer le disque RAM lorsqu'il n'existe pas actuellement. Une fonction tentant d'accéder à un disque RAM inexistant obtiendra une erreur .IDRV.

Le fichier associé à un descripteur de fichier a été supprimé afin que le descripteur de fichier ne puisse plus être utilisé.

Erreur interne. Ne devrait jamais se produire.

Le numéro de sous-fonction passé à la fonction IOCTL (fonction 4Bh) n'était pas valide.

Erreurs de fin de programme

Les erreurs suivantes sont celles pouvant être générées en interne dans le système et transmises aux routines "abort". Ils ne seront normalement pas renvoyés par les appels de fonction. Notez qu'une routine d'abandon peut également être transmise à toute erreur transmise par un programme transitoire à l'appel de fonction "terminer avec code d'erreur".

Les touches CTRL+STOP sont testées à presque tous les endroits du système, y compris toutes les entrées/sorties de caractères.

Les touches CTRL+C ne sont pas testé que sur les fonctions de caractères spécifiant des vérifications d'état.

Cette erreur se produit lorsqu'une erreur de disque est annulée par l'utilisateur ou automatiquement par le système. Le code d'erreur de disque d'origine sera transmis à la routine d'abandon dans le registre B en tant que code d'erreur secondaire.

Renvoyé si une erreur s'est produite sur un canal de sortie standard lors de l'accès par les fonctions de caractères (fonctions 01h..0Bh). Le code d'erreur d'origine est transmis à la routine d'abandon dans le registre B en tant que code d'erreur secondaire. Cette erreur ne se produira normalement que si un programme a modifié les descripteurs de fichiers standard.

Renvoyé si une erreur s'est produite sur un canal d'entrée standard lors de l'accès via les fonctions de caractères (fonctions 01h..0Bh). Le code d'erreur d'origine est transmis à la routine d'abandon dans le registre B en tant que code d'erreur secondaire. L'erreur la plus probable est la fin du fichier (.EOF). Cette erreur ne se produira normalement que si un programme a modifié les descripteurs de fichiers standard.

Erreurs de commande

Les erreurs suivantes ne seront pas renvoyées à partir d'un appel de fonction MSX-DOS, mais sont utilisées par l'interpréteur de commandes. Ils sont inclus ici car un programme transitoire peut trouver utile d'en renvoyer certains.

COMMAND2.COM a chargé sa partie transitoire à partir du disque mais sa somme de contrôle n'était pas celle attendue.

Une commande donnée n'était pas une commande interne et un fichier .COM ou .BAT n'a pas été trouvé avec le même nom.

La commande dans un fichier de traitement par lots dépassait 127 caractères.

Une erreur interne utilisée après l'exécution d'une commande transmise à COMMAND2.COM sur la ligne de commande. (Il n'y a pas de message pour ce code d'erreur.)

Le paramètre d'une commande était invalide d'une manière ou d'une autre, par exemple, un nombre en dehors d'intervalle.

Après avoir analysé tous les paramètres requis pour une commande, il y avait encore plus de caractères non séparateurs sur la ligne de commande.

Là où un paramètre était attendu, la fin de ligne a été trouvée.

La lettre donnée après a/sur la ligne de commande n'était pas valide pour cette commande.

Des caractères non numériques apparaissaient là où un nombre était attendu.

Le fichier d'aide est introuvable ou le paramètre n'est pas un paramètre HELP valide.

Cette erreur n'est jamais utilisée par l'interpréteur de commandes, il a son propre message interne pour cette erreur. Cependant, il est fourni pour les programmes transitoires pouvant trouver utile de renvoyer cette erreur.

Le fichier de destination dans CONCAT correspond à la spécification source.

Dans COPY, la création du fichier de destination écraserait l'un des fichiers source (ou un autre fichier déjà utilisé).

Dans COPY, le fichier de destination, s'il était créé, écraserait le fichier source.

Dans COPY, une source ambiguë a été spécifiée avec une destination non ambiguë, sans répertoire ni périphérique.