Просмтор этого файла доступен только зарегистрированным пользователям. Но у нас супер быстрая регистрация: достаточно только электронной почты!

Текст из файла (страница 15)

Все элементы всех процессорных систем, в которые отображены массивы, зарегистрированные в заданной группе, должны принадлежать текущей процессорной системе. Приём импортируемых элементов группы может быть запущен только в том случае, если предыдущие операции обмена границами этой группы и приема импортируемых элементов завершены с помощью функции waitsh_ (см. п.п. 12.3, 12.5 и 12.6).

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

Ожидание завершения приёма импортируемых элементов осуществляется с помощью функции waitsh_ (см.п.12.6).

Возвращается нулевое значение.

12.5Инициализация передачи экспортируемых элементов заданной группы границ

long sendsh_(ShadowGroupRefPtr *ShadowGroupRefPtr);

*ShadowGroupRefPtr  ссылка на группу границ.

Все элементы всех процессорных систем, в которые отображены массивы, зарегистрированные в заданной группе, должны принадлежать текущей процессорной системе. Передача экспортируемых элементов группы может быть запущена только в том случае, если предыдущие операции обмена границами этой группы и передачи экспортируемых элементов завершены с помощью функции waitsh_ (см. п.п. 12.3, 12.4 и 12.6).

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

Ожидание завершения передачи экспортируемых элементов осуществляется с помощью функции waitsh_ (см.п.12.6).

Возвращается нулевое значение.

Замечание. Последовательность обращений

recvsh_(ShadowGroupRefPtr);

sendsh_(ShadowGroupRefPtr);

эквивалента вызову strtsh_(ShadowGroupRefPtr).

12.6Ожидание завершения обмена границами заданной группы

long waitsh_ (ShadowGroupRef *ShadowGroupRefPtr);

*ShadowGroupRefPtr  ссылка на группу границ.

Функция waitsh_ завершает операцию обмена границами заданной группы, инициированную функцией strtsh_, и разрешает новый запуск обмена границами этой группы. Данной функцией осуществляется также ожидание завершения приема импортируемых или передачи экспортируемых элементов, инициированных функциями recvsh_ или sendsh_ (см. п.п. 12.4 и 12.5). После выполнение функции waitsh_ группа становится открытой для включения в неё распределённых массивов.

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

Возвращается нулевое значение.

12.7Уничтожение группы границ

long delshg_ (ShadowGroupRef *ShadowGroupRefPtr);

*ShadowGroupRefPtr  ссылка на группу границ.

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

Группа границ может быть уничтожена функцией delshg_ только в том случае, если она была создана в текущей подзадаче и в текущем программном блоке (или его подблоке) (см. п. 8 и п. 10). Нельзя уничтожить группу границ, если не завершены запущенные ранее обмен границами, передача экспортируемых элементов или приём импортируемых элементов (см. п.п. 12.3, 12.4 и 12.5).

Группа границ может быть уничтожена также с помощью функции delobj_ (см.п.17.5).

Возвращается нулевое значение.

13Доступ к элементам распределенных массивов

13.1Копирование элемента распределенного массива

13.1.1Чтение элемента распределенного массива и присвоение ему значения

При использовании функции rwelm_ для чтения элемента распределённого массива:

При использовании функции rwelm_ для присвоения значения элементу распределённого массива:

Чтение производится на всех процессорах. При записи модификацию элемента распределённого массива осуществляют лишь те процессоры, в памяти которых размещён заданный элемент.

Число задаваемых в массиве IndexArray индексов должно быть равно размерности читаемого или модифицируемого массива.

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

Возвращается число прочитанных или записанных байтов (длина элемента читаемого или модифицируемого массива).

Замечание. Для избежания предупреждений, выдаваемых Фортран-компилятором при обращении к функции rwelm_ с различными типами переменных, в которые будет осуществляться чтение элемента распределённого массива, в системе поддержки предусмотрена функция

отличающаяся от функции rwelm_ вторым параметром:

Остальные параметры функции rwelmf_ аналогичны соответствующим параметрам функции rwelm_.

13.1.2Копирование элемента одного распределенного массива в элемент другого распределенного массива

Типы читаемого и записываемого элементов должны совпадать.

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

Возвращается число скопированных байтов.

13.1.3Обобщенная пересылка элемента распределенного массива

Функция elmcpy_ является обобщением рассмотренных выше более специализированных функций rwelm_ и copelm_ .

Если FromArrayHeader и ToArrayHeader являются заголовками распределённых массивов, то типы элементов этих массивов должны совпадать.

Если FromArrayHeader (ToArrayHeader) является указателем на область памяти, то содержимое массива FromIndexArray (ToIndexArray) игнорируется. Копирование в этом случае определяется значением *CopyRegimPtr: ненулевое значение *CopyRegimPtr означает, что область памяти предполагается размещённой только на процессоре ввода/вывода. FromArrayHeader и ToArrayHeader не могут быть оба указателями на области памяти.

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

Возвращается число скопированных байтов.

13.2Копирование распределенных массивов

Копирование происходит до исчерпания читаемых или записываемых элементов по принятой в языке C дисциплине непрерывного размещения массивов в памяти: правый индекс меняется быстрее левого. Если начальное значение индекса для какого-либо измерения читаемого или записываемого массива задано большим или равным его конечному значению, то индекс по этому измерению изменяться при копировании не будет. Отметим, что конечное значение индекса для любого измерения рассматривается системой поддержки как минимум между заданным в параметрах обращения к функции и размером массива по этому измерению минус 1.

Для полного охвата измерения читаемого или записываемого массива без использования опроса размера объекта по заданному измерению (см.п.17.2) система поддержки предусматривает задание начального значения индекса равным -1. В этом случае начальное значение индекса будет считаться равным нулю, шаг  единице, а конечное значение  размеру массива по рассматриваемому измерению минус 1.

Характеристики

Список файлов учебной работы