8 О выводе информационных сообщений системы поддержки и сообщений об ошибках

8.1 Функции вывода информационных сообщений и сообщений об ошибках

Каждое сообщение, выдаваемое системой поддержки в процессе своего функционирования, является либо информационным, либо сообщением об ошибке.

Информационные сообщения выводятся с помощью функций rtl_printf, rtl_mprintf (см.п.1.3), а также функцией pprintf со значением параметра prefix, равным 0 или 1 (см.п.7.3).

Кроме того, для вывода информационных сообщений в системе поддержки предусмотрена функция rtl_iprintf, синтаксически эквивалентная функции printf и возвращающая число выведенных символов:

int rtl_iprintf(char *format, . . . );

Информационным сообщением считается также любая трассировочная информация, выводимая функциями tprintf и dvm_trace в поток информационных сообщений системы поддержки (см. п.7.3).

Вывод сообщений об ошибках осуществляется функциями eprintf и epprintf, а также функцией pprintf со значением параметра prefix, равным 2 или 3 (см.п.7.3).

8.2 Управление стандартными выходными потоками и потоками вывода информационных сообщений и сообщений об ошибках

Направление и перенаправление стандартных выходных потоков, а также потоков, предназначенных для вывода информационных сообщений и сообщений об ошибках, осуществляется с помощью параметров, содержащихся в файлах current.par и syspar.* .

Файл current.par является файлом параметров текущего запуска системы поддержки и создаётся программой её запуска в текущей рабочей директории. Он состоит из следующей последовательности строк:

CurrentPar[0] = <параметр>;
CurrentPar[1] = <параметр>;
. . . . . . . . . . . . . . . . . . . . . . . .
CurrentPar[n] = <параметр>;

Расположенными справа от знака "=" параметрами, определяющими вывод информации, могут быть:

1. +o[<путь, определяющий файл>]

Данный параметр даёт указание системе поддержки перевести поток stdout в заданный файл. Если путь, определяющий файл, не задан, то stdout переводится в файл stdout.out .

2. +e[<путь, определяющий файл>]

Параметр задаёт перевод потока stderr в заданный файл. Если путь, определяющий файл, не задан, то stderr переводится в файл stderr.out.

3. +i[<символы, определяющие потоки>]

Данный параметр даёт указание системе поддержки направить информационные сообщения в потоки, определяемые заданными символами.

Символами, определяющими потоки, могут быть:

"o" - поток stdout;
"e" - поток stderr;
"f" - файл.

Если задан как символ "o", так и символ "e", а потоки stdout и stderr в файлы не переведены или переведены в один файл, то вывод информационных сообщений будет осуществляться только в поток stdout (информационные сообщения не дублируются). При направлении информационных сообщений в файл (задан символ "f") его имя (путь) определяется параметром SysInfoFileName файла параметров syspar.* (см. ниже). Если не задано ни одного символа, то информационные сообщения выводиться не будут.

Перенаправление потоков stdout и stderr в файлы может быть осуществлено также с помощью следующих параметров, задаваемых в файле syspar.*:

При вводе и обработке параметров наибольший приоритет имеет самое первое указание о переводе в файл стандартного выходного потока. В частности, перенаправление потоков stdout и stderr с помощью параметров "+o" и "+e" файла current.par подавляет перевод потоков перечисленными выше параметрами файла syspar.* (файл current.par вводится и обрабатывается раньше файла syspar.*).

При отсутствии указания "+i" в файле current.par вывод информационных сообщений определяется параметрами, заданными в файле syspar.* .

Такими параметрами могут быть:

Единичные значения параметров SysInfoStdOut и SysInfoStdErr позволяют при перенаправлении stdout в файл перенаправить информационные сообщения в этот же файл и сохранить их на экране видеомонитора (перевод вывода пользовательской программы в файл должен быть осуществлён с помощью параметра "+o" файла current.par). Манипулируя значениями этих параметров, можно добиться любой комбинации ВИДЕОМОНИТОР - STDOUT, ПЕРЕВЕДЕННЫЙ В ФАЙЛ. Если параметры SysInfoStdOut и SysInfoStdErr равны единице, а потоки stdout и stderr в файлы не переведены или переведены в один файл, то вывод информационных сообщений будет осуществляться только в поток stdout (вывод информации не дублируется).

Отметим, что направление информационных сообщений с помощью параметра "+i" файла current.par имеет приоритет над их направлением, заданным параметрами SysInfoStdOut, SysInfoStdErr и SysInfoFile файла syspar.* .

Вывод информационных сообщений в файл (SysInfoFile = 1) управляется также следующими параметрами файла syspar.*:

При нулевом значении параметра FatInfoNoOpen неудачное открытие файла для информационных сообщений приведёт к выводу предупреждения в поток сообщений об ошибках и продолжению выполнения программы без вывода информационных сообщений в файл.

При нулевом значении SysInfoSepFile каждый процессор направляет информационные сообщения непосредственно в файл, заданный параметром SysInfoFileName. При единичном - каждый процессор накапливает информационные сообщения в своем временном файле, имеющем имя <внутренний номер процессора>.out. Перед завершением работы все временные файлы собираются в один (определённый параметром SysInfoFileName), а затем уничтожаются.

Все сообщения об ошибках:

• выводятся в поток stderr, если потоки stdout и stderr не перенаправлены в один и тот же файл;
• выводятся в поток stdout, если вывод задачи пользователя или поток stderr перенаправлены в файлы;
• выводятся в файл, заданный параметром SysInfoFileName, если параметр SysInfoFile равен единице (в тот же файл, что и информационные сообщения).

Поэтому сообщения об ошибках:

• всегда сопровождают вывод пользовательской задачи;
• всегда поступают на видеомонитор (если потоки stdout и stderr одновременно не переведены в файлы).

Замечание 1. Вывод информационных сообщений до ввода значения параметра SysInfoPrint определяется состоянием общего признака вывода информационных сообщений в момент старта программы (до инициализации системы поддержки). Ненулевое начальное значение этого признака устанавливается в том случае, если система поддержки скомпилирована с предопределённой переменной компиляции _INIT_INFO_ . В противном случае информационные сообщения до ввода параметра SysInfoPrint не выводятся.

Замечание 2. Стандартно вывод информационных сообщений осуществляется следующим образом. До ввода параметров информационные сообщения направлены в поток stdout. Если после ввода параметров SysInfoStdOut и SysInfoStdErr окажется, что первый из них равен нулю, а второй – нет, то информационные сообщения будут перенаправлены в поток stderr. Если же оба параметра будут введены ненулевыми, а потоки stdout и stderr направлены на видеомонитор или связаны с одним и тем же файлом, то вывод информационных сообщений будет продолжен только в поток stdout.

В качестве альтернативы предусматривается вывод информационных сообщений с приоритетом потока stderr. Для этого компиляция системы поддержки должна быть произведена с определённой переменной компиляции _INFO_STDERR_ . В результате поток stderr будет играть такую же роль, что и поток stdout в рассмотренной выше стандартной схеме.

Замечание 3. Если задан вывод информационных сообщений в файл и в поток stdout (stderr), а поток stdout (stderr) переведён в этот же файл, то вывод информационных сообщений в файл блокируется (параметр SysInfoFile устанавливается равным нулю).

8.3 Классы информационных сообщений и управление их выводом

Все информационные сообщения разделены на непересекающиеся классы, каждый из которых связан с функционированием определённой компоненты системы поддержки. Вывод сообщений каждого класса управляется независимо с помощью перечисленных ниже параметров, содержащихся в файлах syspar.*, statist.*, systrace.* и usrdebug.* . По умолчанию считается, что параметр задаётся в файлах syspar.* .

• VersStartPrint – признак вывода номера версии системы поддержки перед началом работы программы.
• VersFullStartPrint – признак вывода номера версии системы поддержки и номеров версий всех файлов параметров перед началом работы программы.
• VersFinishPrint – признак вывода номера версии системы поддержки после окончания работы программы.
• VersFullFinishPrint – признак вывода номера версии системы поддержки и номеров версий всех файлов параметров после окончания работы программы.
• SysParPrint – признак вывода параметров инициализации системы поддержки перед началом работы программы.
• ProcListPrint – признак вывода таблицы процессоров перед началом работы программы. Для каждого процессора выводится его внутренний и внешний номера и идентификатор.
• WeightListPrint – признак вывода весов координат процессоров перед началом работы программы.
• ParamRunPrint – признак вывода информации о параметрах и режимах запуска системы поддержки перед началом работы программы (стандартный или нестандартный запуск, тип базовой системы передачи сообщений и т. д.).
• EndProgMemoryPrint – признак вывода информации о неосвобожденной памяти при завершении работы.
• EndProgObjectPrint – признак вывода информации о неуничтоженных статических DVM-объектах при завершении работы.
• EndProgCheckSumPrint – признак вывода информации о состоянии контролируемых областей памяти при завершении работы.
• InputParPrint – признак вывода сообщений о начале ввода каждого файла параметров.
• EndReadParPrint – признак вывода сообщений о завершении ввода каждого файла параметров.
• TimeExpendPrint - режим вывода информации о расходе времени программой. При нулевом значении данного параметра информация о расходе времени не выводится. Единичное значение задаёт краткий режим вывода информации о расходе времени, большее единицы (2,3,4,5) – подробный. Параметр задаётся в файлах statist.*.
• CallCountPrint – признак вывода статистики обращений к функциям системы подддержки, доступным программе пользователя (для каждой функции сообщается число обращений к ней). Параметр задаётся в файлах statist.*. При единичном значении CallCountPrint выводится информация только о функциях, к которым было хотя бы одно обращение, а при значении, равном 2 – обо всех функциях.
• TraceClosePrint – признак вывода сообщений о завершении выгрузки каждого буфера с накопленной системной трассировкой в файл (при трассировке в буфер оперативной памяти). Параметр задаётся в файлах systrace.*.
• DbgInfoPrint – признак вывода информационных сообщений подсистемы динамического контроля и трассировки вычислений. Параметр задаётся в файлах usrdebug.* .

Сообщения любого класса выводятся только в том случае, если задан общий признак вывода информационных сообщений (с помощью рассмотренного в п.8.2 параметра SysInfoPrint).

9 Измерение времени выполнения участков пользовательской программы

Кроме основных средств анализа производительности и сбора необходимой для этого информации, система поддержки предоставляет вспомогательный механизм измерения времени выполнения участков программы пользователя, при использовании которого результаты измерений выводятся в потоки системной трассировки. Для обозначения начала и конца измеряемого участка используются макровызовы MeasureStart и MeasureFinish. Измеряемые участки могут быть вложенными:

Макровызов MeasureStart эквивалентен обращению к функции dvm_trace (см.п.7.3) с номером события 1 (имя этого события - MeasureStart), а макровызов MeasureFinish - обращению к dvm_trace с номером события 2 (имя этого события - MeasureFinish). В качестве дополнительной информации в открытые потоки трассировки для макровызова MeasureStart выводится уровень вложенности измеряемого участка (1,2, ..., N в вышеприведенной схеме), а для макровызова MeasureFinish - уровень вложенности и время выполнения программы, прошедшее с момента макровызова MeasureStart с тем же уровнем вложенности.

Отметим, что события трассировки с номерами 1 и 2 могут быть, как и любые другие события, выключены, что дает альтернативу изъятию макровызовов MeasureStart и MeasureFinish из программы.

10 Опрос глобального и локального размеров заданного измерения заданного объекта

Функция GetObjectSize возвращает размер объекта, заданного ссылкой ObjRef, по измерению Axis (глобальный размер или размер нераспределённого объекта).

Объектом может быть:

• распределённый массив (тогда ссылка - это первое слово его заголовка);
• представление абстрактной машины;
• многопроцессорная система;
• параллельный цикл.

Размер измерения параллельного цикла равен

ceil( (LastIndex - InitIndex + 1)/Step ) , где:

При нулевом значении Axis возвращается размер всего объекта (произведение размеров всех измерений).

Если ObjRef не является ссылкой ни на один из вышеперечисленных объектов, то функция возвращает нулевое значение.

Функция GetObjectLocSize аналогична рассмотренной выше функции GetObjectSize, но возвращает локальный размер измерения Axis (или локальный размер всего объекта), т.е. размер части объекта, отображённой на текущий процессор. Если объектом является многопроцессорная система, то значения, возвращаемые функциями GetObjectSize и GetObjectLocSize, совпадают.

Отметим, что локальный размер всего объекта, не имеющего локальной части на текущем процессоре, равен нулю.

Функции GetObjectSize и GetObjectLocSize не трассируются и не обрабатываются программой сбора статистики, поэтому отличаются от функций getsiz_ и locsiz_ более быстрым выполнением (см. документ "Библиотека LIB-DVM. Описание интерфейса").

11 Средства обеспечения встроенной в систему поддержки программы сбора статистической информации

11.1 Матрица характеристик выполнения текущего интервала программы пользователя

11.1.1 Первичные характеристики выполнения текущего интервала программы пользователя

Все функции системы поддержки, к которым может обращаться программа пользователя, разделены на следующие непересекающиеся группы:

Имена групп определены как именованные числовые константы языка C в файле system.def исходных текстов системы поддержки. Число групп функций задано именованной константой StatGrpCount. Соответствие <имя функции> => <имя группы> определено в файле исходных текстов intergrp.c.

Характеристики выполнения функций каждой группы накапливаются в матрице расхода времени текущего интервала IM, создаваемой при создании нового текущего интервала (интервальная матрица характеристик, матрица характеристик текущего интервала). Указатель на матрицу IM должен быть помещён при её создании в глобальную переменную

s_GRPTIMES (* CurrInterPtr)[StatGrpCount]; .

При завершении текущего интервала программа сбора статистики должна обработать содержащиеся в матрице IM данные и восстановить в переменной CurrInterPtr указатель на матрицу интервала, в который непосредственно вложен завершаемый интервал.

Матрица IM представляет собой квадратную матрицу, элементы i-й строки которой содержат характеристики выполнения i-й группы функций, вызванных непосредственно программой пользователя. Каждая функция группы i может обращаться (непосредственно или косвенно) к функциям любой группы j (возможно равенство i и j). Характеристики таких обращений накапливаются системой поддержки в элементе IM[i,j]. Таким образом, i-я строка матрицы IM содержит разложение характеристик выполнения функций группы i, вызванных непосредственно программой пользователя, по непосредственным или косвенным обращениям к функциям всех групп.

Каждый элемент IM[i,j] является структурой типа

где:

При создании матрицы IM все перечисленные выше характеристики всех её элементов должны быть проинициализированы нулевыми значениями.

Характеристика CallCount увеличивается всякий раз при выходе из функции группы j на величину 1/n (n - число процессоров, выполняющих текущую ветвь параллельной программы).

Характеристики ProductTime и LostTime увеличиваются при выходе из функции группы j на величины, соответственно, time/n и (n-1)*time/n (time – время выполнения функции группы j без учёта её обращений к функциям других групп, n – число процессоров, выполняющих текущую ветвь).

При завершении выполнения функции, вызванной непосредственно программой пользователя (функции группы i), осуществляется рассмотренное выше увеличение характеристик ProductTime и LostTime, содержащихся в элементе IM[i][i], и увеличение харакеристики CallCount, содержащейся в элементе IM[UserGrp][i] (о строке с номером UserGrp см. ниже). Это, во-первых, позволяет иметь совокупный расход времени функций группы i, вызванных программой пользователя, в одной строке матрицы IM и, во-вторых, располагать информацией о количестве вызовов функций каждой группы, произведённых непосредственно пользовательской программой.

Смысл характеристик, содержащихся в элементах упомянутой выше строки с номером UserGrp, отличается от смысла характеристик других строк матрицы IM. Характеристики ProductTime и LostTime элемента IM[UserGrp][UserGrp] являются собственными полезным и потерянным временами выполнения программы пользователя (без учёта её обращения к функциям системы поддержки). Характеристики ProductTime и LostTime всех остальных элементов строки UserGrp равны нулю. Характеристика CallCount элемента IM[UserGrp][UserGrp] имеет нулевое значение, а для всех остальных элементов IM[UserGrp][j] (j # UserGrp) содержит, как было рассмотрено выше, приведённое к одному процессору число обращений программы пользователя к функциям группы j.

11.1.2 О характеристиках группы функций передачи сообщений

Кроме рассмотренной в п. 11.1 группы функций UserGrp, характеристики выполнения программы для группы функций MsgPasGrp (передача сообщений) также отличаются от одноимённых характеристик остальных групп.

Всё время выполнения любой функции передачи сообщений считается потерянным временем, которое накапливается в характеристике LostTime в "чистом" виде, т. е. без коррекции, учитывающей число процессоров, выполняющих текущую ветвь (без домножения на коеффициент (n-1)/n). Число обращений к функциям передачи сообщений также суммируется в характеристике CallCount без предварительного деления на n. В характеристике ProductTime вместо полезного времени, приведённого к одному процессору, накапливается время реальной (фактической) рассинхронизации программы.

Время реальной рассинхронизации является интегральной мерой потерь полезного времени, вызванных неодновременным выполнением приёма сообщения одним процессором и обращением другого процессора к функции передачи этого же сообщения. Для определения этого времени система поддержки сохраняет в качестве служебной информации, сопровождающей сообщение, астрономическое время обращения к функции передачи сообщения (начало отсчёта астрономического времени на всех процессорах одно и то же, см. выравнивание времён в п.6). В зависимости от применяемой схемы передачи сообщений (см. п.5), время реальной рассинхронизации вычисляется на приёмной стороне следующим образом.

1. Синхронный обмен сообщениями.

Время реальной рассинхронизации полагается равным абсолютному значению разности между временем обращения принимающей стороны к функции rtl_Recv и временем обращения передающей стороны к функции rtl_Send.

2. Асинхронный обмен сообщениями.

Время реальной рассинхронизации равно разности между временем обращения передающей стороны к функции rtl_SendA и временем обращения приёмной стороны к функции rtl_RecvA. Если эта разность отрицательна, то время реальной рассинхронизации считается нулевым.

3. Обмен сообщениями в режиме "NO WAIT".

Время реальной рассинхронизации полагается равным разности между временем обращения передающей стороны к функции rtl_Sendnowait и временем обращения приёмной стороны к функции rtl_Waitrequest. Если эта разность отрицательна, то время реальной рассинхронизации считается нулевым.

Общее время реальной рассинхронизации является суммой времён реальной рассинхронизации отдельных актов взаимодействия <передача-приём>.

11.1.3 Вычисление суммарных характеристик выполнения программы по интервальной матрице характеристик

Будем обозначать множество номеров групп функций как GNS:

GNS = { MsgPasGrp, StartRedGrp, WaitRedGrp, RedGrp, StartShdGrp, WaitShdGrp, ShdGrp, DistrGrp, ReDistrGrp, MapPLGrp, DoPLGrp, PrgBlockGrp, IOGrp, RemAccessGrp, UserDebGrp, StatistGrp, SystemGrp }

1. Характеристика собственного полезного времени выполнения программы (без учёта обращений к функциям системы поддержки):

OUPT = IM[UserGrp][UserGrp].ProductTime

2. Характеристика собственного потерянного времени выполнения программы (без учёта обращений к функциям системы поддержки):

OULT = IM[UserGrp][UserGrp].LostTime

3. Характеристика полезного времени выполнения функций группы i, вызванных непосредственно программой пользователя (i # MsgPasGrp):

4. Характеристика полезного времени выполнения функций системы поддержки, вызванных непосредственно программой пользователя:

5. Характеристика потерянного времени выполнения функций группы i, вызванных непосредственно программой пользователя:

6. Характеристика потерянного времени выполнения функций системы поддержки, вызванных непосредственно программой пользователя:

7. Характеристика полезного времени выполнения программы пользователя:

UPT = OUPT + SPT

8. Характеристика потерянного времени выполнения программы пользователя:

ULT = OULT + SLT

9. Характеристика числа обращений к функциям системы поддержки, осуществлённых непосредственно программой пользователя:

10. Характеристика времени реальной рассинхронизации при выполнении функций группы i, вызванных непосредственно программой пользователя:

RMT_i = IM[i][MsgPasGrp].ProductTime

11. Характеристика времени реальной рассинхронизации при выполнении программы пользователя:

12. Характеристика собственного полезного времени выполнения функций группы j (без учёта обращений к функциям других групп) (j # MsgPasGrp):

13. Характеристика собственного потерянного времени выполнения функций группы j (без учёта обращений к функциям других групп):

11.1.4 Вспомогательная матрица характеристик задачи пользователя

В целях контроля и отладки накопления и визуализации информации для анализа производительности в системе поддержки предусмотрена вспомогательная матрица характеристик выполнения программы пользователя:

s_GRPTIMES TaskInter[StatGrpCount][StatGrpCount]; .

Матрица TaskInter соответствует начальному интервалу выполнения программы пользователя. Накопление в ней информации осуществляется независимо от функционирования основного механизма сбора статистики. Характеристики выполнения программы, содержащиеся в элементах матрицы TaskInter, не подвергаются коррекции числом процессоров, выполняющих текущую ветвь.

При завершении выполнения программы заданная часть матрицы TaskInter выводится в поток информационных сообщений системы поддержки.

Управление накоплением информации в матрице TaskInter и её (информации) выводом осуществляется с помощью параметров TimeExpendPrint и StatGrpName файлов statist.* . При нулевом значении параметра TimeExpendPrint накопление информации в матрице TaskInter не производится. Ненулевое значение этого параметра задаёт режим накопления и определяет состав и форму выводимой информации:

11.1.5 Обеспечение накопления характеристик DVM-операций ввода/вывода, реализованных в Фортране

Стандартно при вызове программой пользователя любой функции системы поддержки номер группы этой функции запоминается в глобальной переменной

int CurrOper; .

При выполнении вызванной функции и при завершении её выполнения значение переменной CurrOper используется как номер строки матрицы IM для сохранения в ней измеренных характеристик.

Выполнение DVM-операций ввода/вывода в Фортране сопровождается обращениями к функциям системы поддержки, не являющихся функциями ввода/вывода. Поэтому для правильного накопления характеристик Фортран-операций ввода/вывода необходимо:

• установить в начале операции ввода/вывода значение переменной CurrOper, равным IOGrp (выполняется функция ввода/вывода);
• не менять значение переменой CurrOper при обращении программы пользователя к любой функции системы поддержки до завершения операции ввода/вывода;
• отменить запрет изменения значения переменной CurrOper при завершении операции ввода/вывода.

Для выполнения перечисленных требований система поддержки предоставляет функции

void biof_(void);

и

void eiof_(void); .

Обращение к функции biof_ осуществляется программой пользователя в начале операции ввода/вывода. Функция biof_ присваивает переменной CurrOper значение, равное IOGrp, и устанавливает в единицу значение глобальной переменной

unsigned char CurrOperFix; .

При ненулевом значении переменной CurrOperFix значение переменной CurrOper не меняется при обращении программы пользователя к функциям системы поддержки.

Функция eiof_ предназначена для оповещения системы поддержки о завершении операции ввода/вывода. Её выполнение заключается в присвоении переменной CurrOperFix нулевого значения, разрешающего изменение значения переменной CurrOper.

11.2 Средства внешнего управления программой сбора статистики

Внешнее управление функционированием программы сбора статистики осущ ествляется с помощью следующих задаваемых в файлах statist.* параметров:

11.3 Инициализация программы сбора статистики

При инициализации программы сбора статистики получают значения, соответствующие рассмотренным в п.11.2 внешним параметрам, следующие глобальные переменные:

После инициализации перечисленных выше глобальных переменных для более конкретной настройки сбора статистики осуществляется обращение к функции

void stat_init(void); (файл statist.c).

Функция stat_init должна, в частности, предоставить системе поддержки начальную интервальную матрицу характеристик (инициализировать указатель CurrInterPtr, см. п. 11.1.1).

После выхода из функции stat_init сбор статистики считается системой поддержки включённым.

11.4 Обработка программой сбора статистики обращений к функциям системы поддержки

После выхода из рассмотренной в п.11.3 функции stat_init система поддержки начнёт производить накопление характеристик выполнения программы пользователя в предоставленной ей интервальной матрице характеристик.

Подсчёт характеристик в матрице IM осуществляется при обращении и возврате из любой функции системы поддержки, доступной программе пользователя. Вход и выход из части функций системы поддержки требуют, однако, дополнительной обработки. К таким функциям относятся функции, времена обращений и возврата из которых необходимы для вычисления потенциальной рассинхронизации и разброса времён программы пользователя. При обращении и/или возврате из такой функции система поддержки производит обращение к функции

void stat_event(int EventNumber); (файл statist.c),

где EventNumber - номер наступившего события трассировки. Параметр EventNumber однозначно определяет как обрабатываемую функцию, так и тип наступившего события (вход в обрабатываемую функцию или выход из неё).

Обращение к функции stat_event по событию EventNumber осуществляется лишь в том случае, если EventNumber-й элемент глобального массива

unsigned char IsStat[];

не равен нулю. Ненулевое значение байта IsStat[EventNumber] (1-255) определяет конкретный вариант обработки события с номером EventNumber функцией stat_event. Инициализация массива IsStat осуществляется в модуле системы поддержки statevnt.c, где для входа и выхода каждой функции системы поддержки, доступной программе пользователя, задаётся нулевое или ненулевое значение соответствующего элемента массива IsStat.

Кроме того, обращение к функции stat_event производится только при выполнении следующих общих для всех обрабатываемых функций условий:

• включён подсчёт времени реальной рассинхронизации и разброса времён (параметр запуска системы поддержки IsTimeVariation задан ненулевым);
• обрабатываемая функция вызвана непосредственно программой пользователя или функцией системы поддержки dopl_ для запуска или ожидания обмена границами;
• обрабатываемая функция не является функцией, вызванной программой пользователя при выполнении DVM-операции ввода/вывода в Фортране (значение глобальной переменной CurrOperFix равно нулю, см. п. 11.1.5).

Перед обращением к функции stat_event система поддержки осуществляет запись в глобальную переменную

ObjectRef StatObjectRef;

ссылку на текущий обрабатываемый объект. Таким объектом, в зависимости от наступившего события, может быть:

• многопроцессорная система;
• представление абстрактной машины;
• распределённый массив;
• карта отображения распределённого массива;
• параллельный цикл;
• редукционная переменная;
• редукционная группа;
• группа границ распределённых массивов.

Для распределённого массива в переменную StatObjectRef записывается 0-е слово его заголовка.

Ссылка на текущий обрабатываемый объект, содержащаяся в переменной StatObjectRef, может использоваться программой сбора статистики для получения справочной информации об объекте с помощью функций системы поддержки.

Отметим, что перед обращением к функции stat_event система поддержки запоминает текущее астрономическое время в глобальной переменной

double Curr_dvm_time; .

Поэтому при выполнении функции stat_event опроса текущего времени с помощью функции dvm_time не требуется.

11.5 Завершение работы с программой сбора статистики

При завершении пользовательской программы система поддержки производит обращение к функции

void stat_done(void); (файл statist.c)

для завершающей обработки программой сбора статистики собранной информации (если такая обработка требуется). После выхода из этой функции система поддержки запишет буфера накопления статистики всех процессоров в двоичный файл, имя которого определено параметром внешнего управления StatFileName (см. п.11.2). Буфера процессоров расположатся в этом файле непрерывно в порядке возрастания их (процессоров) внутренних номеров. Далее сбор статистики считается выключенным.

11.6 Доступ к некоторой системной информации

Могущие оказаться необходимыми характеристики системы поддержки и аппаратурно-программной среды, в рамках которой она функционирует, содержатся в следующих глобальных переменных.