[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 ежедневно.

.ст Раздел II:1.3

[an error occurred while processing this directive]