[an error occurred while processing this directive]
.км Описания драйвера DIR 4.06.EXE
.ао0
.ло9
.по74
.кс0
.ми0
.лв
.тт
.шп16
.цв
FRIENDS' SOFTWARE 1994
DIRECTORY TREE DRIVER
(Описание для программистов и пользователей)
.лв
.шп8
Аннотация
---------
.шп0
Настоящий документ содержит описание драйвера "DIR 4.06.EXE" ("Friends' software", by Serkov S.V.), предназначенного для работы с директориями в интерпретаторе "BASIC-AGAT 9.1" (при наличии в памяти DOS 3.3). Драйвер поддерживает формат ведения директорий на диске, принятый в системах "BEST TOOL KIT"(начиная с версии 92.10) и "NORTON 5.0"
.шп8
Введение
--------
.шп0
Как известно, формат каталога диска в DOS 3.3 несколько не удобен для пользователя тем, что упомянутая система ведет один общий каталог файлов для всего диска. Это затрудняет и удлиняет по времени поиск нужного файла. Поэтому предложенный в свое время еще на АГАТе-7 (по-видимому Головым А.А.) способ разбиения диска на директории (то есть подкаталоги) дает не мало преимуществ пользователю. Например, можно разбить все файлы диска на смысловые группы и хранить их в разных директориях.
(О формате ведения директорий см. Описания DOS 3.3 Серкова С.В. или обращайтесь к самому автору).
Итак эта проблема была решена, и в настоящее время пользователь "BTK", "NORTON" и "BASIC-AGAT 9.1" могут использовать все преимущества этого метода.
.шп8
Назначение драйвера "DIR"
-------------------------
.шп0
Драйвер предназначен для возможности переключения подкаталогов, созданных "BTK" и тем самым дает возможность работать с файлами расположенными в разных директориях в "BASIC-AGAT 9.1".
Данная версия драйвера не позволяет создавать, удалять и переименовывать директории. (Такая возможность будет реализована в последующих версиях).
.шп8
Особенности данной версии
-------------------------
.шп0
Многие пользователи уже работали с более ранними версиями драйвера "DIR" (например с версией 4.03). Версия 4.06 отличается от других версий драйвера следующим:
1. Улучшены некоторые подпрограммы.
2. Настоящая версия (4.06) соответствует стандарту драйверов
процедур от 1.08.94.
3. Драйвер работает с системой обработки резидентных драйверов - "Диспетчер v.1.00" (описание системы см. отдельно).
4. Драйвер имеет команду "EXIT"
.сс
.шп8
Особенности загрузки
--------------------
.шп0
Драйвер загружается в память с адреса ¤5DDC. Его длина составляет ¤A30 байт. После установки драйвера его объектный код в ОЗУ может быть утерян так как интерпретатор драйвера и сам модуль переносятся в банк D на адреса ¤A000-¤A80C (5-й сегмент). Обращение к драйверу занимает адреса ¤390-¤3B8. Таким образом драйвер не нарушает работу программы пользователя. Его можно загрузить в память при помощи команды DOS "BRUN".
* Примечание:
При попытке повторной загрузки драйвера в режиме диалога будет выдана "ОШИБКА УСТАНОВКИ", а такое же действие из BASIC-программы будет сопровождено ошибкой "УЖЕ ЕСТЬ" или обработано согласно "ONERR GOTO" (подробнее см. Описание модуля "SETDRMOD.ASM (версия 15.08.94).
.шп8
Команды драйвера
----------------
.шп0
Для работы драйвера необходимы наличие DOS 3.3 и интерпретатора "BASIC". Драйвер использует вектор свободного ключевого слова "&" интерпретатора, по этому все команды начинаются с него.
&"LIST" - выдает список команд драйвера &"DIR"{,S,D} - просмотр списка директорий в данном каталоге &"CD\"{,S,D} - включить корневой каталог &"CD."{,S,D} - включить каталог предыдущего уровня (для первого это корневой) &"CD",NAME {,S,D} - включить подкаталог с именем NAME &"CD?"{,S,D} - включить подкаталог по выбору &"EXIT" - выключить драйвер и выйти из системы "Диспетчер"
Параметры S (разъем) и D (привод) необязательны. Может быть записан только параметр S. Могут быть использованы не только непосредственные значения NAME, S и D, но и соответствующие любые текстовые (вместо имени) и арифметические (в качестве параметров S и D) выражения в формате интерпретатора вместо них.
Например:
.шп1
10 A=10:B=4:PR¤(2)="BAS-AGAT9.1" 20 &"CD",LEFT¤(PR¤(2)),3+"IC",(A-2)/4+3,SQR(B)
.шп0
Команда в сторке 20 включит директорию с именем "BASIC" на дисководе в 5 слоте 2-го привода или выдаст ошибку "ДИРЕКТОРИЯ НЕ НАЙДЕНА" если таковой не имеется.
.шп8
Сообщения об ошибках
--------------------
.шп0
Драйвер выдает следующие сообщения об ошибках:
"ОШИБКА ОБМЕНА" "ДИСК ЗАКРЫТ НА ЗАПИСЬ" "ДИРЕКТОРИЯ НЕ НАЙДЕНА" "ДЛИННОЕ ИМЯ"
.сс
При неправильном наборе команды интерпретатор выдает сообщение о синтаксической ошибке. Соответствующие сообщения выдаются при неправильном задании параметров S и D итд...
При наличии в программе оператора ONERR GOTO эти сообщения не выдаются, а код ошибки записывается в ячейку BASERR (¤DE)
Коды ошибок соответствуют стандартным кодам ошибок интерпретатора и DOS (см. описание соответствующих систем).
* Примечание:
Код ошибки "ДЛИННОЕ ИМЯ" соответствует коду ошибки DOS "НЕВЕРНОЕ ЗНАЧЕНИЕ" (02). Эта ошибка выдается если имя директории в теле команды &"CD" составляет более 30 знаков.
.шп8
Рекомендации
------------
.шп0
Старайтесь пользоваться версиями драйвера начиная с данной.
Версия 4.03 также лишена ошибок, но не поддерживает работу с системой "Диспетчер" и лишена других преимуществ.
.шп8
Заключение
----------
.шп0
По всем вопросам можно обращаться к автору по телефону:
.шп8
.цв
(095) 400-6865
.шп0; с 17 до 21 ежедневно.
[an error occurred while processing this directive]