[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

Ассоциирование информации со статусом

В MPI-1 запросы были связаны с двухточечными операциями. В MPI-2 запросы могут быть также связаны с вводом-выводом или, через механизм обобщенных запросов, с определяемыми пользователем операциями. Все эти запросы можно сделать с помощью MPI_{TEST|WAIT}{ANY|SOME|ALL}, которые возвращают статус объекта с информацией о запросе. Статус содержит пять значений, из которых три являются доступными как поля и два, ``счетчик'' и ``отменен'', скрытыми. MPI-1 представляет функции доступа для восстановления этих скрытых полей. Соответственно, чтобы для MPI-2 обобщенные запросы могли работать, функция query_fn, введенная в предыдущей секции, должна иметь доступ к этим двум полям. Две подпрограммы, описанные в этой секции, обеспечивают эти функциональные возможности. Значения, явно не устанавливаемые, являются неопределенными.

MPI_STATUS_SET_ELEMENTS(status, datatype, count)

INOUT	status	Статус, связанный со счетчиком (статус)
IN	datatype	Тип данных, связанный со счетчиком (указатель)
IN	count	Число элементов, связанных со счетчиком (целое)

int MPI_Status_set_elements(MPI_Status *status,
                            MPI_Datatype datatype,
                            int count)

MPI_STATUS_SET_ELEMENTS (STATUS, DATATYPE, COUNT, IERROR)
     INTEGER STATUS(MPI_STATUS_SIZE), DATATYPE, COUNT, IERROR

void MPI::Status::Set_elements(const MPI::Datatype& datatype, int count)

Этот запрос изменяет скрытую часть статуса и вызов MPI_GET_ELEMENTS будет возвращать счетчик. MPI_GET_COUNT возвратит совместимое значение.

Объяснение: Число элементов устанавливается вместо счетчика типов данных, потому что последний может оперировать с нецелыми типами данных.

Последующий вызов MPI_GET_COUNT (status, datatype, count) или
MPI_GET_ELEMENTS (status, datatype, count) должен обрабатывать аргумент datatype, который имеет то же самое значение, что и аргумент datatype, который использовался при вызове
MPI_STATUS_SET_ELEMENTS.

Объяснение: Это подобно ограничению, которое накладывается тогда, когда счетчик устанавливается получающей операцией: в этом случае, вызовы MPI_GET_COUNT и MPI_GET_ELEMENTS должны использовать тот же тип данных, что используется в получающем вызове.

MPI_STATUS_SET_CANCELLED(status, flag)

INOUT	status	Статус, связанный со счетчиком (статус)
IN	flag	Если истинен, то показывает, что запрос отменен (логический )

int MPI_Status_set_cancelled(MPI_Status *status, int flag)

MPI_STATUS_SET_CANCELLED(STATUS, FLAG, IERROR)
   INTEGER STATUS(MPI_STATUS_SIZE), IERROR
   LOGICAL FLAG

void MPI::Status::Set_cancelled(bool flag)

Если flag установлен в ``истину''(true), то последующий вызов MPI_TEST_CANCELLED(status,flag) также вернет flag=true, в противном случае он вернет false.

Совет пользователям: Пользователям мы советуем не использовать повторно поля статуса со значениями, отличными от тех, для которых они предназначены. Такие действия могут привести к неожиданным результатам при использовании статуса объекта. Например, вызывая MPI_GET_ELEMENTS можно спровоцировать ошибку, если значение входит из диапазона, кроме того, может быть невозможно обнаружить такую ошибку. Экстра-State аргумент, переданный обобщенному запросу, может использоваться для возврата информации, которая логически не принадлежит статусу. Кроме того, модификация значений в статусе - внутренняя задача MPI, например, MPI_RECV может привести к непредсказуемым результатам и настоятельно не рекомендуется.

Партнёры:

Хостинг: