| ★ CODING ★ CLASSEURS WEKA ★ CLASSEURS WEKA : Comment exploiter toutes les ressources et augmenter les performances de votre AMSTRAD CPC ★ |
| 3/4.2.2 - Table d'indirection des fonctions BDOS en page zéro | Coding Classeurs Weka |
Les fonctions BDOS sont accessibles à travers la page zéro par un numéro de fonction. Elles sont activées en assembleur en chargeant dans le registre C le numéro de la fonction désirée. Eventuellement, un ou plusieurs paramètres peuvent être échangés à travers les autres registres.Nous allons donner la liste des fonctions BDOS de CP/M + de 0 à 152. Fonction 0: SYSTEM RESET
L'appel à cette fonction a le même effet qu'un saut à l'adresse #0000. Le système est initialisé et le contrôle est donné au CCP. Sous CP/M + , le système disque n'est pas initialisé par l'appel à cette fonction. Le programme appelant peut passer un code de retour au CCP en activant la fonction 108 avant de faire appel à la fonction BDOS 0. Fonction 1: CONSOLE INPUT
Cette fonction attend qu'un caractère soit entré sur l'unité logique CONIN : (clavier) pour rendre le contrôle au programme appelant et stocke le code ASCII de ce caractère dans le registre A. Les caractères CR, LF, BS et CTRL-H ont un écho sur l'écran. Les fabulations CTRL-I sont converties en déplacements de 8 caractères et ont un écho sur l'écran. Lorsque le mode d'affichage est celui par défaut, les caractères CTRL-S (stop scroll), CRTL-Q (start scroll) et CTRL-P (start/stop print echo) sont interceptés par la fonction BDOS 1 et ont un écho sur l'écran. Cependant, si les fonctions associées à cas caractères sont dévalidées par le mode d'affichage, CTRL-S, CTRL-Q et CTRL-P ne sont pas interceptés par la fonction BDOS 1 et n'ont donc aucun écho sur l'écran. Fonction 2 : CONSOLE OUTPUT
Cette fonction envoie le caractère dont le code ASCII se trouve dans le registre E sur l'unité CONOUT: (écran). Lorsque le mode d'affichage est celui par défaut, la fonction BDOS 2 le caractère CTRL-I est converti en une tabulation de 8 caractères, et les caractères CTRL S, CTRL-Q et CTRL P sont interprétés. Fonction 3 : AUXILIARY INPUT
Cette fonction permet de lire un caractère sur l'entrée AUXIN:. Fonction 4 : AUXILIARY OUTPUT
Cette fonction envoie le caractère dont le code ASCII se trouve dans le registre E sur l'unité logique AUXOUT:. Fonction 5 : LIST OUTPUT
Cette fonction envoie le caractère dont le code ASCII se trouve dans le registre E sur l'unité logique LST:. Fonction 6 : DIRECT CONSOLE I/O
Cette fonction BDOS permet de lire (avec ou sans attente) ou d'écrire un caractère sur l'unité CONIN:, en fonction de la valeur contenue dans le registre E:
Fonction 7 : AUXILIARY INPUT STATUS
Cette fonction renvoie dans le registre A l'état de l'entrée auxiliaire AUXIN:. Le registre A prend la valeur # FF si un caractère n'est pas disponible sur AUXIN: et #00 si aucun caractère n'est disponible sur AUXIN:. Fonction 8 : AUXILIARY OUTPUT STATUS
Cette fonction renvoie dans le registre A l'état de la sortie auxiliaire AUXOUT:. Le registre A prend la valeur # FF si la sortie auxiliaire AUXOUT: est prête à recevoir un caractère et #00 si AUXOUT: n'est pas prête à recevoir un caractère. Fonction 9 : PRINT STRING
Cette fonction envoie une chaîne de caractères sur la sortie logique CONOUT: jusqu'à ce que le caractère délimiteur $ soit rencontré dans la chaîne. La fonction BDOS 110 permet de changer la valeur ASCII du caractère délimiteur. Lorsque le mode d'affichage est le mode par défaut, la fonction BDOS 9 convertit les caractères tabulations CTRL-I en déplacements de 8 caractères et les caractères CTRL-Q, CTRL-S et CTRL-P sont interprétés. Fonction 10 : READ CONSOLE BUFFER
Cette fonction lit une « ligne » sur l'unité logique CONIN: et range les caractères lus dans le buffer dont l'adresse de début est donnée dans le registre DE. La « ligne » est considérée terminée lorsqu'un des caractères suivants est rencontré : CTRL-M, CTRL-J ou CR. Un caractère BEL (CTRL-G) est envoyé sur CONOUT: lorsque le buffer est plein. L'adresse pointée par le contenu du registre DE doit être positionnée avant l'appel à la fonction BDOS 10. Son contenu est la longueur maximum du buffer de lecture (entre 1 et 255). Les données lues sont rangées en (DE+ 2), (DE+3), etc. La mémoire (DE+ 1) contient le nombre de caractères lus (entre 0 et (DE)). Si DE = #0000, la fonction BDOS 10 suppose que le buffer de lecture est initialisé (DE + 2) à (DE + n + 1 ) contiennent les valeurs désirées et (DE + n + 2) le terminateur #001 et se trouve par défaut à l'adresse DMA courante. Lorsque le terminateur est rencontré, BDOS 10 attend une entrée de caractère(s) sur CONIN:. Cette méthode permet à l'opérateur d'accepter la chaîne qui est affichée (il presse alors ENTER! ou de la modifier en utilisant au besoin les caractères de contrôle suivants :
Fonction 11 : GET CONSOLE STATUS
Cette fonction indique si un caractère a été tapé sur l'unité logique CONIN:. Fonction 12 : RETURN VERSION NUMBER
Cette fonction retourne dans le registre HL le numéro de version du fichier système BDOS. De cette manière les logiciels CP/M peuvent exploiter les possibilités particulières de chaque CP/M et ainsi fonctionner sur des CP/M de versions différentes. Fonction 13 : RESET DISK SYSTEM
Cette fonction positionne le système de fichiers BDOS dans un état initial (disque par défaut - A:, adresse de DMA par défaut : #0080, lecteurs) de disques positionné(s) en lecture/écriture). Fonction 14 : SELECT DISK
Cette fonction définit le disque qui sera accédé par défaut pour toutes les opérations CP/M à venir. Le registre E désigne ce disque : 0 pour le lecteur A jusqu'à 15 pour le lecteur P. En retour de fonction, le registre A est à zéro si la définition du disque par défaut s'est déroulée correctement. Dans le cas contraire, la valeur de A dépend du mode d'erreur BDOS:
Fonction 15 : OPEN FILE
Cette fonction active le FCB (File Control Block) d'un fichier disque qui appartient au numéro d'utilisateur courant (ou zéro). L'adresse du FCB est donnée dans le registre DE. Elle pointe sur une zone mémoire qui respecte les conventions suivantes :
Si le fichier que l'on tente d'accéder est protégé en lecture, le mot de passe correct doit se trouver dans les huit premiers octets de la zone DMA courante ou avoir été défini par la fonction BDOS 106. Lorsque le numéro d'utilisateur courant n'est pas zéro, et que le fichier que l'on tente d'ouvrir par la fonction 15 n'existe pas sous le numéro d'utilisateur courant, le fichier spécifié est cherché sous le numéro d'utilisateur zéro. Pour que l'ouverture aboutisse, il est nécessaire que le fichier ait l'attribut « système » positionné. Les données renvoyées par la fonction BDOS 15 sont les suivantes : Code répertoire dans le registre A:
Code d'erreur dans le registre H:
Fonction 16 : CLOSE FILE
Cette fonction ferme un fichier ouvert par une des fonctions BDOS 15 ou 22. L'attribut d'interfaçage f5 indique si la fermeture du fichier est permanente (f5 = 0) ou partielle (f5= 1). Dans ce dernier cas, le fichier est maintenu ouvert mais le repertoire est mis à jour. Les données renvoyées par la fonction BDOS 16 sont les suivantes : Code répertoire dans le registre A:
Code d'erreur dans le registre H:
Un message d'erreur est affiché si le mode d'erreur est celui par défaut. Sinon, le registre A est positionné à #FF et le registre H contient :
Fonction 17 : SEARCH FOR FIRST
Cette fonction recherche dans le répertoire courant le premier fichier qui s'accorde avec les éléments fournis dans le FCB (File Control Bloc). L'adresse du FCB est spécifiée dans le registre DE. Rappelons la structure du bloc FCB :
La fonction BDOS 17 peut être complétée par la fonction BDOS 18 (SEARCH FOR NEXT) qui détermine le ou les fichiers suivants qui satisfont les données indiquées dans le bloc FCB. Les données renvoyées par la fonction BDOS 17 sont les suivantes :
Un message d'erreur est affiché si le mode d'erreur est celui par défaut.
Fonction 18 : SEARCH FOR NEXT
Cette fonction est identique à la fonction BDOS 17, à ceci près qu'elle poursuit la recherche de fichier qui avait commencé par une fonction 17. Fonction 19 : DELETE FILE
Cette fonction permet d'effacer le fichier dont le FCB correspond à celui pointé par le registre DE. La structure du FCB est donnée dans la fonction BDOS 17. Les champs « nom du fichier » et « extension » peuvent contenir des jockers « ? ». L'attribut d'interfaçage f5 définit le type d'effacement désiré.
Les données renvoyées par la fonction BDOS 19 sont les suivantes : Code répertoire dans le registre A: Ce code contient zéro si l'effacement s'est bien déroulé, et #FF sinon. Code d'erreur dans le registre H: Si le code renvoyé dans le registre A est 0 ou #FF, le registre H contient la valeur zéro. Un message d'erreur est affiché si le mode d'erreur est celui par défaut. Sinon, le registre A est positionné à #FF et le registre H contient :
Fonction 20 : READ SEQUENTIAL
Cette fonction transfère de 1 à 128 enregistrements de 128 octets d'un fichier disque ouvert vers la mémoire centrale à partir de l'adresse DMA courante. Reportez-vous à la fonction BDOS 44 pour définir le nombre d'enregistrements) à lire.
Fonction 21: WRITE SEQUENTIAL
Cette fonction transfère de 1 à 128 enregistrements de 128 octets de la mémoire centrale (à partir de l'adresse DMA courante) vers un fichier ouvert. Reportez-vous à la fonction BDOS 44 pour définir le nombre d'enregistrements) à écrire. Les données renvoyées par la fonction BDOS 21 sont les suivantes :
Fonction 22 : MAKE FILE
Cette fonction crée :
L'adresse du FCB est passée à la fonction 22 dans le registre DE. Le premier octet (octet 0) du FCB contient le numéro du lecteur de disquettes, les octets suivants (1 à 11) indiquent le nom du fichier et son type. L'octet 12 indique le numéro d'extension (souvent zéro). L'attribut f6 indique si un mot de passe doit ou non être attribué au fichier (f6 = 0 pour qu'aucun mot de passe ne soit attribué, f6 = 1 pour qu'un mot de passe soit attribué). Lorsque l'attribut f6 est positionné, le mot de passe doit être placé dans les huit premiers octets du buffer courant de DMA. La fonction MAKE FILE renvoie un code d'erreur si le FCB fait référence à un nom de fichier déjà existant dans le répertoire courant. MAKE FILE initialisé également les champs « date de création » et « date de mise à jour » du fichier si :
Le registre H est nul dans ces deux cas. Si une erreur d'ordre physique ou étendu survient, un message est affiché et le programme appelant est avorté dans le cas où le mode d'erreur BDOS est le mode standard. Dans un autre cas, le retour vers l'appelant se fait avec un des codes d'erreur suivant :
Fonction 23 : RENAME FILE
Cette fonction renomme un fichier ou un groupe de fichiers en passant par le FCB dont l'adresse se trouve dans le registre DE. Les seize premiers octets du FCB contiennent le nom du fichier à renommer, et les seize suivants, le nouveau nom du fichier. Lorsque l'accès au fichier nécessite un mot de passe, celui-ci doit être placé dans les huit premiers octets du buffer de DMA courant, ou encore doit avoir été déclaré comme mot de passe courant grâce à la fonction BDOS 106. En sortie, RENAME FILE renvoie un code répertoire nul dans A si tout s'est bien passé, et un code répertoire égal à # FF si le fichier à renommer n'a pu être trouvé dans le répertoire courant. Le registre H est nul dans ces deux cas. Si une erreur physique ou étendue se produit, la fonction RENAME FILE réagit différemment en fonction du mode d'erreur BDOS. Si c'est le mode standard, un message d'erreur est envoyé à l'écran, et le programme est avorté. Sinon, un code d'erreur est retourné au programme appelant selon la convention suivante :
Fonction 24 : RETURN LOGIN VECTOR
Cette fonction indique quel est le lecteur de disque actif. La convention de codage du registre HL en sortie de fonction est la suivante : le bit 0 du registre HL représente le lecteur A, le bit 15 du registre HL représente le lecteur P. Un des bits de HL positionné à un indique quel est le lecteur actuellement actif. Fonction 25: RETURN CURRENT DISK
Cette fonction indique le numéro du lecteur de disque par défaut. Pour ce faire, le registre A prend une valeur comprise entre 0 et 15, correspondant respectivement aux lecteurs A à P. Fonction 26 : SET DMA ADDRESS
Sous CP/M +, une zone en mémoire est définie dans le but de stocker un enregistrement (ou plus) issu d'une lecture sur disque ou destiné à être écrit sur disque. La fonction BDOS 44 (SET MULTI-SECTOR COUNT) permet de définir la taille de cette zone mémoire. L'adresse de DMA la plus fréquente est #0080. C'est également l'adresse initialisée par la fonction BDOS 13. La fonction SET DMA ADDRESS modifie cette adresse qui reste ainsi initialisée jusqu'à ce qu'elle soit changée par un autre appel à la fonction 26 ou jusqu'à ce qu'un RESET se produise. Fonction 27 : GET ADDR
Cette fonction permet de lire l'adresse de base du vecteur d'allocation du lecteur de disque courant. Ce vecteur se trouve en mémoire RAM et permet entre autres de déterminer la quantité de mémoire libre sur une disquette. Lorsqu'aucune erreur physique ne se produit, le registre HL contient l'adresse du vecteur. Dans le cas contraire, le registre HL contient 0FFFF. Fonction 28 : WRITE PROTECT DISK
Cette fonction permet de positionner temporairement (jusqu'au prochain « DRIVE RESET ») un lecteur de disquettes ou de disque dur en lecture seule. De cette manière, tout accès en écriture sur ce lecteur (pour renommer ou effacer un fichier, écrire des données, etc.) sera refusé. Fonction 29 : GET READ-ONLY VECTOR
Cette fonction renvoie un vecteur dans HL dont chaque bit à un identifie un lecteur autorisé à lecture seule. Le bit de poids le plus faible correspond au lecteur A:, le bit de poids le plus fort correspond au lecteur P:. Fonction 30 :SET FILE ATTRIBUTES
Cette fonction permet de modifier les attributs d'un fichier et de positionner les derniers compteurs d'octets. Les attributs que peut modifier cette fonction sont les suivants :
Le FCB accédé par l'adresse contenue dans le registre DE doit contenir le nom du fichier dont les attributs vont être modifiés ainsi que (es attributs positionnés comme nécessaire. Si le fichier est protégé par un mot de passe, ce dernier doit se trouver dans les huit premiers octets du buffer de DMA ou avoir été spécifié comme mot de passe par défaut par la fonction 106. L'attribut f6 indique si le compteur du dernier enregistrement doit être modifiéEn sortie, SET FILE ATTRIBUTES renvoie un code répertoire nul dans le registre A si tout s'est bien passé, et un code répertoire égal à #FF dans le registre A si le fichier à accéder n'a pu être trouvé dans te répertoire courant. Le registre H est nul dans ces deux cas. Si une erreur physique ou étendue se produit, la fonction SET FILE ATTRIBUTES réagit différemment en fonction du mode d'erreur BDOS. Si c'est le mode standard, un message d'erreur est envoyé à l'écran, et le programme est avorté. Sinon, un code d'erreur est retourné au programme appelant selon la convention suivante :
Fonction 31 : GET ADDR
Cette fonction lit l'adresse du DPB (Disk Parameter Block) du disque courant et la stocke dans le registre HL. Si une erreur physique se produit alors que le mode d'erreur BDOS est un des modes de retour, la valeur #FFFF est renvoyée dans le registre HL. (Cf. Fonction 45). Fonction 32 : SET/GET USER CODE
Lorsque le registre E vaut #FF, le numéro d'utilisateur est renvoyé dans le registre A en sortie de la fonction. Si le registre E est différent de # FF, le numéro utilisateur devient celui indiqué dans le registre E (modulo 16). Fonction 33 : READ RANDOM
Cette fonction est identique à la lecture séquentielle, à ceci près que le pointeur de lecture est placé sur un enregistrement particulier avant d'effectuer la lecture. La position de lecture est indiquée dans les octets rO (poids faible), r1 et r2 (poids fort) qui se trouvent dans le FCB à partir de la position 33. Avant d'utiliser la fonction READ RANDOM, te fichier concerné doit avoir été ouvert avec une dimension de base 0. Lorsque le compteur de secteurs BDOS est plus grand que 1, la fonction READ RANDOM lit un nombre d'enregistrements en conséquence. Les champs r0, r1 et r2 sont automatiquement incrémentés. En sortie de la fonction READ RANDOM, le registre A contient 0 si tout s'est déroulé correctement. Si ce n'est pas le cas, A contient un des codes d'erreur suivants :
Lorsqu'une erreur physique est détectée (A=255), le registre H contient 01 si une erreur d'entrée/sortie s'est produite et 04 si le lecteur de disquette ou de disque dur ne peut être accédé. Fonction 34 : WRITE RANDOM
Cette fonction est identique à la précédente, à ceci près qu'elle provoque une écriture et non une lecture dans le fichier ouvert. En sortie de la fonction WRITE RANDOM, le registre A contient 0 si tout s'est déroulé correctement. Si ce n'est pas le cas, A contient un des codes d'erreur suivants :
Fonction 35 : COMPUTE FILE SIZE
Cette fonction détermine la taille d'un fichier. Cette taille est la taille réelle si le fichier est accédé en séquentiel, mais elle est inférieure à la taille réelle si le fichier est accédé en direct. Pour ce faire, le pointeur d'enregistrement du FCB (passé en entrée dans DE) est positionné sur le dernier enregistrement +1 du fichier. En sortie, le registre A est nul si la fonction s'est déroulée correctement. Le registre A contient #FF si le fichier spécifié n'a pas été trouvé. Dans ces deux cas, le registre H est positionné à zéro. Si une erreur physique se produit, la fonction COMPUTE FILE SIZE réagit différemment selon le mode d'erreur BDOS courant. Si ce mode est Je mode par défaut, un message d'erreur est affiché à l'écran, et le programme appelant est avorté. Dans un autre cas, le registre H peut contenir une des valeurs suivantes :
Fonction 36 : SET RANDOM RECORD Numéro du prochain enregistrement accédé
Cette fonction indique dans les champs r1, r2 et r3 du FCB la position du prochain enregistrement accédé par une instruction de lecture ou d'écriture séquentielle. Fonction 37 : RESET DRIVE Initialisation des lecteurs de disquettes
Cette fonction positionne les lecteurs de disquettes dans un état initial. Le numéro du lecteur de disquettes est indiqué dans le registre DE en entrée de la fonction. Le bit de poids faible de ce registre correspond au lecteur A:. Le bit de poids fort correspond au lecteur P:, Lorsqu'un bit est à un, il désigne Je lecteur à réinitialiser. Fonction 38 : ACCESS DRIVE Fonction 39 : FREE DRIVE Fonction 40 : WRITE RANDOM WITH ZERO FILL
Identique à la fonction 34 (WRITE RANDOM) à ceci près qu'une zone mémoire est initialisée à 0 avant l'accès à la disquette. Si cette fonction a été utilisée pour créer un fichier, les enregistrements non écrits accé-dés par la fonction 33 {READ RANDOM) contiendront des zéros. Si le fichier avait été créé par la fonction 34 (WRITE RANDOM), ces mêmes enregistrements contiendraient des valeurs quelconques non prévisibles. Fonction 41 : TEST AND WRITE RECORD Fonction 42 : LOCK RECORD Fonction 43 : UNLOCK RECORD Fonction 44 : SET MULTI-SECTOR COUNT
Cette fonction définit le nombre de secteurs tus à chaque accès direct à un fichier en lecture ou en écriture. Le registre E contient le nombre de secteurs entre 1 et 128. Ce nombre reste ainsi défini jusqu'à ce que la fonction UNLOCK RECORD soit appelée. En sortie, le registre A contient 0 si le registre E a été passé avec une valeur comprise entre 1 et 128. Sinon, le registre A contient #FF. Fonction 45 : SET BDOS ERROR MODE
Cette fonction définit le mode d'erreur du BDOS en fonction de ia valeur qui se trouve dans le registre E au moment de l'appel :
Fonction : 46 GET DISK FREE SPACE
Cette fonction renvoie le nombre de secteurs (128 octets) de disquette non utilisés. Le résultat se trouve dans les trois premiers octets du buffer DMA. Le premier représente le poids faible, le second le poids intermédiaire et le troisième le poids fort. En sortie, le registre A vaut 0 si la fonction a pu s'exécuter et un cod< d'erreur dans le cas contraire. Dans ce cas, le registre H contient l'uni des deux valeurs suivantes :
Fonction 47 : CHAIN TO PROGRAM
Cette fonction permet de lancer l'exécution d'un programme à partir du programme courant. Pour ce faire, le buffer DMA doit contenir une ligne de commande terminée par un octet nul. Lorsque le registre E vaut 0 en entrée de la fonction, le programme est appelé avec les valeurs par défaut du lecteur et du numéro d'utilisateur. Dans le cas contraire, le lecteur et le numéro d'utilisateur sont issus des valeurs par défaut du CCP. Fonction 48 : FLUSH BUFFERS
Cette fonction force l'écriture du ou des buffer(s) de données non vides. Ce (ou ces) buffer(s) est (sont) effacé(s) si le registre E vaut # FF en entrée. En sortie, le registre A vaut 0 si la fonction a pu s'exécuter. Dans le cas contraire, un code d'erreur physique est éventuellement retourné dans le registre H (en fonction du mode d'erreur courant, voir fonction 45) :
Fonction 49 : GET/SET SYSTEM CONTROL BLOCK
Cette fonction permet d'accéder {en lecture ou en écriture) aux données qui se trouvent dans le SCB (System Control Block). Reportez-vous à la Partie 3, Chap. 4.2,1.2 pour prendre connaissance de la structure du SCB. Les registres D et E pointent sur une structure qui identifie l'opération effectuée dans le SCB. Cette structure est la suivante :
RO = Read Only (lecture seule) Fonction 50 : DIRECT BIOS CALLS
Cette fonction permet d'accéder aux fonctions du BIOS. Le numéro de la fonction à accéder et la valeur des registres en entrée sont spécifiés dans le bloc de paramètres (BIOSPB) dont l'adresse se trouve dans le registre DE en entrée de la fonction. Le bloc de paramètres doit avoir la structure suivante :
Fonction 59 : LOAD OVERLAY
Cette fonction ne peut être utilisée que par les programmes résidants. Elle charge en mémoire un module relogeable ou absolu. Le FCB spécifié dans DE soit être ouvert avant d'activer la fonction BDOS 59. Le registre A est nul en sortie de la fonction si elle a pu s'exécuter. Dans le cas contraire, le registre A contient un code d'erreur et le registre H un code d'erreur physique. Reportez-vous à la fonction BDOS 20 pour avoir la liste des erreurs possibles (voir Partie 3, Chap. 4.2.2 p. 10). Fonction 60 : CALL RESIDENT SYSTEM EXTENSION
Cette fonction permet d'activer une des fonctions d'une RSX. Cette fonction ainsi que les paramètres passés sont définis dans un bloc de paramètres dont la structure est la suivante :
Les registres A et H contiennent #FF en sortie si le RSX spécifié n'est pas accessible. Fonction 98 : FREE BLOCKS
Cette fonction libère tous les blocs occupés par des fichiers temporaires (c'est-à-dire des fichiers ouverts en écriture mais non fermés) sur tous les lecteurs connectés. Assurez-vous que vos fichiers ont bien été fermés avant d'appeler cette fonction, sans quoi, les données qu'ils contiennent seront perdues. Le registre A contient la valeur 0 en sortie de la fonction si elle a pu s'exécuter. Dans le cas contraire, le registre A contient la valeur #FF et le registre H (en fonction du mode d'erreur) la valeur # 04 (lecteur invalide). Fonction 99 : TRUNCATE FILE
Cette fonction initialisé le dernier enregistrement d'un fichier au numéro d'enregistrement qui se trouve dans le FCB pointé par DE. Le fichier représenté par le FCB ne doit pas être ouvert. #FF si le fichier n'existe pas ou si le numéro d'enregistrement est fantaisiste. Le registre H contient (en fonction du mode d'erreur) une des valeurs suivantes :
Fonction 100 : SET DIRECTORY LABEL
Cette fonction crée urt label de répertoire ou met à jour un label de répertoire existant. En entrée de la fonction, lé registre DE doit pointer sur l'adresse d'une FCB dans lequel se trouvent les champs nom, type et extension du label de répertoire. L'octet 12 du FCB contient les informations suivantes :
Dans le cas où le fichier est protégé par un mot de passe, ce dernier doit se trouver dans les 8 premiers octets du DMA ou avoir été spécifié dans la fonction BDOS 106. Si le bit 0 de l'octet 12 du FCB vaut 1, le nouveau mot de passe doit avoir été placé dans le second jeu de 8 octets du DMA. L'Utilitaire INITDIR doit avoir été exécuté avant d'activer cette fonction pour permettre l'utilisation des champs date et heure. Le registre A vaut 0 en sortie si la fonction s'est exécutée. Il vaut # FF dans le cas contraire, et le registre H contient un des codes suivants (si le mode d'erreur le permet) :
Fonction 101 : RETURN DIRECTORY LABEL DATA
Cette fonction renvoie dans le registre A le label de répertoire du lecteur spécifié. Les bits de ce registre ont la signification suivante :
Fonction 102 : READ FILE DATE STAMPS AND PASSWORD MODE Lecture des champs date et heure et du type de mot de passe.
Cette fonction renvoie dans le FCB tes informations date et heure et le type de l'éventuel mot de passe utilisé pour le fichier spécifié :
La valeur retournée dans le registre A est 0 si la fonction s'est exécutée, #FF si le fichier n'existe pas. Le registre H contient (en fonction du mode d'erreur) une des valeurs suivantes :
Cette fonction crée un XFCB ou met à jour un XFCB existant. En entrée, le registre DE pointe sur un FCB pour lequel les champs nom, type et extension ont été initialisés. Le champ extension spécifie le type de mot de passe utilisé :
Dans le cas où le fichier est protégé par un mot de passe, ce dernier doit se trouver dans les 8 premiers octets du DMA ou avoir été spécifié dans la fonction BDOS 106. Si le bit 0 de l'octet 12 du FCB vaut 1, le nouveau mot de passe doit avoir été placé dans le second jeu de 8 octets du DMA. La valeur retournée dans le registre A est 0 si la fonction s'est exécutée, # FF si le fichier n'existe pas ou si aucun label n'existe pour le répertoire spécifié. Le registre H contient (en fonction du mode d'erreur) une des valeurs suivantes :
Initialisation de la date et de l'heure système.
Cette fonction initialisé les date et heure courantes. Le registre DE pointe sur un buffer qui contient les informations suivantes :
Cette fonction renvoie les date et heure systèmes dans le buffer pointé par le registre DE. En sortie de la fonction, ce buffer contient les informations suivantes :
Fonction 106 : SET DEFAULT PASSWORD
Cette fonction définit le mot de passe par défaut. En entrée de la fonction, le registe DE soit pointer sur une zone mémoire de 8 octets dans laquelle se trouve le mot de passe. Fonction 107 : RETURN SERIAL NUMBER
Cette fonction renvoie le numéro de série de CP/M Plus dans un buffer de 6 octets pointé par le registre DE en entrée de la fonction. Fonction 108 : GET/SET PROGRAM RETURN CODE
Cette fonction lit ou définit un code de retour. Si le registre DE vaut #FFFF en entrée de la fonction, le code de retour du programme est renvoyé dans le registre HL. Si le registre DE est différent de #FFFF en entrée de la fonction, il est interprété comme le code de retour du programme. Fonction 109 : GET/SET CONSOLE MODE
Cette fonction lit ou initialisé le mode d'écran. Si le registre DE vaut #FFFF en entrée de la fonction, le mode d'écran est retourné dans le registre HL selon les conventions suivantes :
Fonction 110 : GET/SET OUTPUT DELIMITER
Cette fonction lit ou initialisé le délimiteur de sortie. Si le registre DE contient # FFFF en entrée de la fonction, le délimiteur courant est retourné Jans Je registre A. Si le registre E ne contient pas la valeur #FF, il représente le code ASCII du nouveau délimiteur. Le délimiteur par défaut est le signe dollar ($). Fonction 111 : PRINT BLOCK
Cette fonction envoie la chaîne pointée par le CCB dont l'adresse se trouve dans le registre DE vers le périphérique CONOUT:. Le format du CCB doit être le suivant :
Cette fonction envoie la chaîhe pointée par le CCB dont l'adresse se trouve dans le registre DE vers le périphérique LST:. Le format du CCB doit être le suivant :
Cette fonction crée un FCB à partir d'une chaîne ASCII de 128 caractères au maximum qui doit contenir une spécification de fichier sous la forme suivante : [ < Lecteur: > ] < Nom > [. < Type > ][; < Passe > ]
Le registre DE pointe sur un buffer qui doit contenir les informations suivantes ::
Espace, Tab, Carriage Return, Nul, Point Virgule (;), Egal à ( = ), Inférieur à (< ), Supérieur à O), Deux points (:), Point (.), Virgule (,), Barre verticale (I), Crochet ouvrant ([), Crochet fermant (]). La rencontre d'un autre caractère de code ASCII inférieur à 31 produit une erreur.
Si aucune erreur ne s'est produite, HL contient 0 si la chaîne a été entièrement parcourue et la position du prochain délimiteur, blanc, ou tabu-lation dans le cas contraire.
|
