LIBDVM~1 (1158353), страница 5
Текст из файла (страница 5)
Отметим, что события трассировки с номерами 1 и 2 могут быть, как и любые другие события, выключены, что дает альтернативу изъятию макровызовов MeasureStart и MeasureFinish из программы.
10.ОПРОС ГЛОБАЛЬНОГО И ЛОКАЛЬНОГО РАЗМЕРОВ ЗАДАННОГО ИЗМЕРЕНИЯ ЗАДАННОГО ОБЪЕКТА.
| long GetObjectSize( | ObjectRef | ObjRef, |
Функция GetObjectSize возвращает размер объекта, заданного ссылкой ObjRef, по измерению Axis (глобальный размер или размер нераспределенного объекта).
Объектом может быть:
-
распределенный массив (тогда ссылка - это первое слово его заголовка);
-
представление абстрактной машины;
-
многопроцессорная система;
-
параллельный цикл.
Размер измерения параллельного равен
ceil( (LastIndex - InitIndex + 1)/Step ) , где
| InitIndex | - начальное значение индексной переменной параллельного цикла для измерения Axis; |
| LastIndex | - конечное значение индексной переменной параллельного цикла для измерения Axis; |
| Step | - шаг изменения индексной переменной параллельного цикла для измерения Axis; |
| Ceil | - функция нахождения наименьшего целого, не меньшего значения своего аргумента. |
При нулевом значении Axis возвращается размер всего объекта (произведение размеров всех измерений).
Если ObjRef не является ссылкой ни на один из вышеперечисленных объектов, то функция возвращает нулевое значение.
| long GetObjectLocSize( | ObjectRef | ObjRef, |
Функция GetObjectLocSize аналогична рассмотренной выше функции GetObjectSize, но возвращает локальный размер измерения Axis (или локальный размер всего объекта), т.е. размер части объекта, отображенной на текущий процессор. Если объектом является многопроцессорная система, то значения, возвращаемые функциями GetObjectSize и GetObjectLocSize, совпадают.
Отметим, что локальный размер всего объекта, не имеющего локальной части на текущем процессоре, равен нулю.
Функции GetObjectSize и GetObjectLocSize не трассируются и не обрабатываются программой сбора статистики, поэтому отличаются от рассмотренных в документе dvmlib23.doc функций getsiz_ и locsiz_ более быстрым выполнением.
11.СРЕДСТВА ОБЕСПЕЧЕНИЯ ВСТРОЕННОЙ В СИСТЕМУ ПОДДЕРЖКИ ПРОГРАММЫ СБОРА СТАТИСТИЧЕСКОЙ ИНФОРМАЦИИ
11.1.Средства внешнего управления
Внешнее управление функционированием программы сбора статистики осуществляется с помощью следующих задаваемых в файлах параметров:
| Is_DVM_STAT | - признак включенного сбора статистики (файлы systrace.rel и systrace.deb); |
| StatBufLength | - длина буфера для сбора статистики в байтах для одного процессора (файлы systrace.rel и systrace.deb); |
| StatFileName | - имя файла, в который будут выгружены буфера сбора статистики из всех процессоров решающего поля (файлыsystrace.rel и systrace.deb); |
| IsStat[EventNumb] | - задаваемый ненулевым значением признак включенного для обработки программой сбора статистики события трассировки с номером EventNumb (файлы trcevent.nst и trcevent.std). Ненулевым значением этого признака (1-255) могут задаваться различные варианты обработки программой сбора статистики события с номером EventNumb. |
11.2.Инициализация программы сбора статистики
При инициализации программы сбора статистики получают значения (соответствующие рассмотренным в п.11.1 внешним параметрам) следующие глобальные переменные:
| сhar* StatBufPtr | - указатель на буфер для сбора статистической информации; |
| long StatBufLength | - длина в байтах буфера для сбора статистической информации; |
| unsigned char IsStat[] | - массив, i-й элемент которого содержит байт – признак включенного для обработки программой сбора статистики события трассировки с номером i. |
После инициализации перечисленных выше глобальных переменных для более конкретной настройки сбора статистики осуществляется обращение к функции
void stat_init(void); (файл statist.c).
После выхода из этой функции сбор статистики считается системой поддержки включенным.
11.3.Обработка программой сбора статистики событий трассировки
После выхода из рассмотренной в п.11.2 функции stat_init при наступлении каждого включенного для обработки программой сбора статистики события трассировки система поддержки будет производить обращение к функции
void stat_event(int EventNumber); (файл statist.c).
где EventNumb - номер наступившего события трассировки.
Байт-признак включенного для обработки программой сбора статистики события трассировки может быть получен как IsStat[EventNumber].
Перед обращением к функции stat_event система поддержки осуществляет запись в глобальную переменную
ObjectRef StatObjectRef;
ссылку на текущий обрабатываемый объект. Таким объектом, в зависимости от наступившего события, может быть:
-
многопроцессорная система;
-
представление абстрактной машины;
-
распределенный массив;
-
карта отображения распределенного массива;
-
параллельный цикл;
-
редукционная переменная;
-
редукционная группа;
-
группа границ распределенных массивов.
Для распределенного массива в переменную StatObjectRef записывается 0-е слово его заголовка.
Ссылка на текущий обрабатываемый объект, содержащаяся в переменной StatObjectRef, может использоваться программой сбора статистики для получения справочной информации об объекте с помощью функций системы поддержки.
Если наступившим событием является обращение или выход из какой-либо рассмотренной в п.5 функции передачи сообщений, то перед обращением к функции stat_event система поддержки фиксирует в глобальной переменной
int StatProcNumber;
внутренний номер процессора, которому передается или от которого принимается сообщение.
11.4.Завершение работы с программой сбора статистики
При завершении пользовательской программы система поддержки производит обращение к функции
void stat_done(void); (файл statist.c)
для завершающей обработки программой сбора статистики собранной информации (если такая обработка требуется). После выхода из этой функции система поддержки запишет буфера накопления статистики всех процессоров в двоичный файл, имя которого определено параметром внешнего управления StatFileName (см.п.11.1). Буфера процессоров расположатся в этом файле непрерывно в порядке возрастания их (процессоров) внутренних номеров. Далее сбор статистики считается выключенным.
11.5. Доступ к некоторой системной информации
Могущие оказаться необходимыми характеристики системы поддержки и аппаратурно-программной среды, в рамках которой она функционирует, содержатся в следующих глобальных переменных.
| long MPS_TYPE | - тип системы передачи сообщений. Может принимать значения (указаны именованные константы): EMP_MPS_TYPE, GNS_MPS_TYPE, ROU_MPS_TYPE, MPI_MPS_TYPE, PVM_MPS_TYPE. |
| long ProcCount | - число процессоров выделенного задаче решающего поля. |
| unsigned char VMSRank | - размерность многопроцессорной системы, в которой функционирует система поддержки. |
| long VMSSize[] | - массив, i-й элемент которого содержит размер многопроцессорной системы по измерению i+1 (0 ≤ i ≤ VMSRank-1). |
| int MPS_CurrentProc | - внутренний номер текущего процессора. |
| int MPS_IOProc | - внутренний номер процессора ввода/вывода. |
| int MPS_CentralProc | - внутренний номер центрального процессора. |
12.СООБЩЕНИЯ ОБ ОШИБКАХ, ВОЗНИКАЮЩИХ ПРИ РАБОТЕ СИСТЕМЫ ПОДДЕРЖКИ
Сообщения об ошибках, возникающих в процессе функционирования системы поддержки, делятся (по степени серьезности последних) на предупреждения и сообщения об ошибках, прерывающих выполнение программы. Ошибки, прерывающие выполнение программы, могут быть обычными, ответственность за которые лежит (скорее всего) на пользователе, и фатальными, требующими, возможно, участия разработчика или его представителя.
В соответствии с этим сообщения об ошибках имеют один из следующих видов:
| *** RTL warning | <номер класса ошибки> . <номер ошибки внутри класса> : <текст сообщения об ошибке> |
| *** RTL err | <номер класса ошибки> . <номер ошибки внутри класса> : <текст сообщения об ошибке> |
| *** RTL fatal err | <номер класса ошибки> . <номер ошибки внутри класса> : <текст сообщения об ошибке> |
Класс ошибки определяется функциональной и модульной структурой системы поддержки.
Каждому сообщению об ошибке предшествует вывод имени файла и номера строки, в которой произошла ошибка, как пользовательской программы, так и системы поддержки:
USRFILE=<имя файла программы пользователя>; USRLINE=<номер строки>;
SYSFILE=<имя файла системы поддержки>; SYSLINE=<номер строки>;
По характеру возникновения ошибки делятся на две группы. Первую группу составляют ошибки, возникающие только на всех процессорах сразу. Сообщения об этих ошибках выводит процессор ввода/вывода. Вторая группа состоит из ошибок, которые могут происходить не на всех процессорах "одновременно". Сообщения о таких ошибках выводит каждый процессор самостоятельно, сопровождая каждое сообщение своими внутренним и внешним номерами. При работе на одном процессоре все сообщения об ошибках выводятся без его номеров.
В системе поддержки предусмотрены возможности вывода всех сообщений об ошибках первой группы всеми процессорами и вывода всех сообщений об ошибках второй группы только процессором ввода/вывода. Первая возможность достигается установкой значения параметра MultiProcErrReg (файлы параметров syspar.*) равным 2. Для вывода сообщений об ошибках второй группы только процессором ввода/вывода значение этого параметра должно быть нулевым (эта возможность используется только в экспериментальных целях). Стандартное значение параметра MultiProcErrReg равно единице.
Ниже рассмотрены сообщения об ошибках с их тематическим разбиением и в порядке возрастания номеров классов и номеров ошибок внутри класса.
12.1.ИНИЦИАЛИЗАЦИЯ СИСТЕМЫ ПОДДЕРЖКИ И ЗАВЕРШЕНИЕ РАБОТЫ С НЕЙ
*** RTL fatal err 000.000: wrong call linit_ (no memory)
![](https://s.studizba.com/z.php?f=/templates/si/i/noavatar.png&w=100&h=100&t=1"){kind=avatar}
