Intel® Fortran Compiler Classic and Intel® Fortran Compiler Developer Guide and Reference

ID 767251
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

CO_BROADCAST

Collective Intrinsic Subroutine (Generic): Broadcasts a value to other images.

CALL CO_BROADCAST (a, source_image [, stat, errmsg])

a

(Input; output) Must have the same shape, dynamic type, and type parameter values in corresponding references across all participating images. It cannot be a coindexed object. If an error occurs, it becomes undefined. Otherwise, a becomes defined as if by intrinsic assignment with the value a on image source_image on all images of the current team.

source_image

(Input) Must be a scalar integer. The value of source_image must the value of an image index of an image on the current team. Its value must be the same in corresponding references on all images participating in the collective operation.

stat

(Output; optional) Must be a non-coindexed integer scalar with a decimal exponent range of at least four (KIND=2 or greater). The value assigned to stat is specified in Overview of Collective Subroutines. If stat is not present and an error condition occurs, error termination is initiated.

errmsg

(Input; output; optional) Must be a non-coindexed default character scalar variable. The semantics of errmsg is described in Overview of Collective Subroutines.

Example

Consider the following:

CALL CO_BROADCAST (R, 5) 

If R is a four-element array defined with the value [10, 20, 30, 40] on image 5 when the subroutine is referenced, R becomes defined with the value [10, 20, 30, 40] on all images of the current team if no error condition occurs during the subroutine reference.