.PL 72
.PN 28
.HE                                          Manual de interfata CP/M
.fo                                                                #
--------------------------------------------------------
|                                                      |
|    RUTINA 29 : Citire vector de unitati R/O          |
|                (Get Read/Only Vector)                |
|                                                      |
|    Intrari :                                         |
|              registrul C    : 1DH                    |
|                                                      |
|    Iesiri  :                                         |
|              registrele H&L : vectorul de unitati R/O|
|                                                      |
--------------------------------------------------------

Efect:   rutina  intoarce in registrele "H&L" un vector ce indica 
unitatile  de  disc care sint desemnate ca R/O  in  acel  moment. 
Bitul B0 din registrul "L" corespunde unitatii "A",  iar bitul B7 
din  registrul "H" corespunde unitatii "P".  O valoare logica "1" 
indica faptul ca unitatea respectiva este R/O.

O  unitate de disc devine R/O dupa un apel al rutinei 28  sau  in 
urma  schimbarii volumului disc din acea unitate (sistemul  CP/M, 
in acest caz, desemneaza automat unitatea respectiva ca R/O).


.cp 34
--------------------------------------------------------
|                                                      |
|    RUTINA 30 : Modificare atribute fisier            |
|                (Set File Attributes)                 |
|                                                      |
|    Intrari :                                         |
|              registrul C    : 1EH                    |
|              registrele D&E : adresa FCB             |
|                                                      |
|    Iesiri  :                                         |
|              registrul A    : cod "director"         |
|                                                      |
--------------------------------------------------------

Efect:   rutina  permite  modificarea atributelor R/O si SYS  ale 
unui  fisier  specificat in FCB-ul a carui adresa  este  data  in 
registrele  "D&E".  FCB-ul  trebuie sa contina  un  specificator-
individual de fisier.  Noile atribute ale fisierului se specifica 
prin:

   - bitul  B7  din  octetul 09 din FCB  ("1"  reprezinta  fisier        
     protejat la scriere (R/O));

   - bitul  B7  din  octetul 10 din FCB  ("1"  reprezinta  fisier        
     invizibil (SYS)).

Rutina  cauta in "director" o intrare care  corespunde  octetilor 
1-11  din FCB;  comparatia se face ignorind valorile bitilor B7 
din  octetii 1-11 din FCB si din "director".  Daca o astfel  de 
intrare  este  gasita rutina modifica  intrarea   din  "director" 
corespunzatoare.   Rutina  intoarce  in registrul "A"  o  valoare   
0-3  pentru cazul in care operatia s-a desfasurat corect sau  o 
valoare egala cu 255 (0FFH) pentru cazul in care nu fost gasita o 
astfel de intrare.


.cp 21
--------------------------------------------------------
|                                                      |
|    RUTINA 31 : Citire adresa "bloc parametri disc"   |
|                (Get Disk Parms Addr)                 |
|                                                      |
|    Intrari :                                         |
|              registrul C    : 1FH                    |
|                                                      |
|    Iesiri  :                                         |
|              registrele H&L : adresa bloc parametri  |
|                               disc                   |
--------------------------------------------------------

Efect:   rutina  intoarce in registrele "H&L" adresa "blocului de 
parametri ai discului", bloc care este rezident in BIOS.  Aceasta 
adresa poate fi folosita:

   - pentru  a  extrage din zona  respectiva  informatii  privind        
     parametrii   discului  (informatii  necesare  pentru  a   fi        
     afisate sau pentru a se realiza, pe baza lor, calcule);

   - pentru  a modifica,  prin program,  parametrii discului;  de        
     obicei  programele  de aplicatii nu folosesc  rutina  31  in        
     acest scop.


.cp 21
--------------------------------------------------------
|                                                      |
|    RUTINA 32 : Citire/modificare numar utilizator    |
|                (Set/Get User Code)                   |
|                                                      |
|    Intrari :                                         |
|              registrul C    : 20H                    |
|              registrul E    : 0FFH pentru citire     |
|                               numar utilizator pentru|
|                                 modificare           |
|                                                      |
|    Iesiri  :                                         |
|              registrul A    : numar utilizator daca  |
|                                E a fost 0FFH         |
--------------------------------------------------------

Efect:   rutina  permite citirea numarului utilizatorului  curent 
(daca (E)=0FFH) si intoarcerea acestui numar in registrul "A" sau 
modificarea numarului utilizatorului curent, in functie de valoa
rea curenta a registrului "E" (modulo 16).   Numarul utilizatoru
lui curent variaza intre 00H si 0FH.
.pa
--------------------------------------------------------
|                                                      |
|    RUTINA 33 : Citire directa                        |
|                (Read Random)                         |
|                                                      |
|    Intrari :                                         |
|              registrul C    : 21H                    |
|              registrele D&E : adresa FCB             |
|                                                      |
|    Iesiri  :                                         |
|              registrul A    : octet de stare         |
|                                                      |
--------------------------------------------------------

Efect:  rutina este similara rutinei "citire secventiala" (rutina 
20)  cu exceptia faptului ca nu se citeste din fisier inregistra
rea de 128 de octeti cu numarul specific<@ aLx y	A@s@$x.nL.L<$<sc" `  3b Bbc s` 3` b ` qa q Csb` 3L&' sd b ` sqsa q sb` 3f'3a"a"zinta o valoare pe 16  biti 
cuprinsa intre 0000H - 0FFFFH cu partea cea mai putin  semnifica
tiva  in  octetul  33  si cea mai semnificativa  in  octetul  34. 
Octetul 35 trebuie sa fie 00H intrucit o valoare diferita de  00H 
indica o "depasire" dincolo de sfirsitul fisierului.

Citirea  directa  necesita  in prealabil  deschiderea  "extensiei 
logice"  cu  numarul 0 a fisierului (prima  "extensie  logica"  a 
fisierului), operatie care se realizeaza prin rutina 15.

Daca operatia de citire directa s-a efectuat corect, atunci:

   - registrul "A" va avea valoarea 00H;

   - inregistrarea  citita  din  fisier  se  va  gasi  depusa  in        
     memorie la "adresa DMA";

   - valorile  octetilor 12 (numarul "extensiei logice"  curente)        
     si  32  (numarul inregistrarii in cadrul "extensiei  logice"        
     curente)  vor  fi automat modificate in functie  de  numarul        
     inregistrarii citite (octetii 33 si 34);

   - valoarea  octetului  32  nu va fi incrementata cu 1  (ca  in        
     rutina 20).

Dupa  o operatie de "citire directa" pot fi folosite operatii  de 
"citire  secventiala/scriere  secventiala".   Programatorul  insa 
trebuie  sa  tina  cont de faptul ca prima  operatie  de  "citire 
secventiala/scriere  secventiala" se va aplica  asupra  aceleeasi 
inregistrari  care  s-a preluat prin "citire  directa"  (intrucit 
octetul  32  nu  a  fost incrementat cu 1).  Se  poate,  printr-o 
"citire secventiala" falsa, incrementa octetul 32 din FCB, astfel 
incit  operatiile de "citire/scriere secventiala" urmatoare sa se 
aplice  asupra inregistrarilor care urmeaza celei  preluate  prin 
"citire directa".

Daca  operatia  de  "citire directa" s-a aplicat  asupra  ultimei 
inregistrari dintr-o "extensie logica",  nu se realizeaza automat 
deschiderea "extensiei logice" urmatoare (ca in rutina 20).

.cp 8
Daca operatia de "citire direcda" nu s-a efectuat corect,  atunci 
registrul "A" va contine codul de eroare, respectiv:

   - 01        citirea unei inregistrari nescrise;

   - 03        imposibilitate de  inchidere a "extensiei  logice" 
               curente (trebuie redeschisa sau recitita "extensia 
               logica" numarul 0 a fisierului);

   - 04        acces  la o "extensie logica" a fisierului care nu 
               a fost creata;

   - 06        octetul  35 este diferit de 00H (incercare de cau
               tare in afara limitelor fizice ale fisierului).

In general,  codurile de eroare diferite de 00H pot fi  interpre
tate ca "lipsa de date".


.cp 32
--------------------------------------------------------
|                                                      |
|    RUTINA 34 : Scriere directa                       |
|                (Write Random)                        |
|                                                      |
|    Intrari :                                         |
|              registrul C    : 22H                    |
|              registrele D&E : adresa FCB             |
|                                                      |
|    Iesiri  :                                         |
|              registrul A    : octet de stare         |
|                                                      |
--------------------------------------------------------

Efect:   rutina  este  identica cu rutina de "citire directa"  cu 
exceptia  faptului ca o inregistrare de 128 de octeti  aflata  in 
memorie la "adresa DMA" este scrisa pe disc.  Inregistrarea se va 
scrie  in fisier in pozitia corespunzatoare numarului ei (octetii 
33  si  34).  Daca acestei pozitii nu ii  fusese  alocat  spatiu, 
atunci rutina realizeaza aceasta alocare inainte de scriere.

In  urma unei operatii de "scriere directa" valorile octetilor 12 
si 32 se modifica, dar octetul 32 nu se incrementeaza cu 1. Toate 
observatiile  referitoare  la rutina 33 sint valabile  si  pentru 
rutina 34.

Daca  operatia de "scriere directa" s-a efectuat  corect,  atunci 
registrul "A" va avea valoarea 00H;  in caz contrar el va contine 
codul  de  eroare.  Codurile de eroare posibile sint cele  de  la 
rutina  33  plus codul 05 care  indica  imposibilitatea  scrierii 
datelor  intrucit  nu  a  mai fost spatiu  in  "director"  pentru 
crearea unei noi "extensii logice".