co_broadcast

Date:

10-18-2019

NAME

CO_BROADCAST - Broadcast a value to all images of the current team in a Fortran application

SYNOPSIS

CO_BROADCAST (A,SOURCE_IMAGE[,STAT,ERRMSG])

IMPLEMENTATION

Cray Linux Environment (CLE)

DESCRIPTION

CO_BROADCAST is an intrinsic collective subroutine that broadcasts a value to corresponding elements on all images of the current team in a Fortran application.

Support for non-contiguous A arrays is deferred.

This subroutine accepts the following options:

A shall have the same shape, dynamic type, and type parameter values, in corresponding references. It shall not be a coindexed object. It is an INTENT (INOUT) argument. If no error condition occurs, A becomes defined, as if by intrinsic assignment, on all images in the current team with the value of A on image SOURCE_IMAGE.

SOURCE_IMAGE shall be an integer scalar. It is an INTENT (IN) argument. Its value shall be that of an image index of an image in the current team. The value shall be the same in all corresponding references.

STAT shall be a noncoindexed integer scalar with a decimal exponent range of at least four. It is an INTENT (OUT) argument. If the STAT argument is present in a reference to a collective subroutine on one image, it shall be present on all the corresponding references. If the STAT argument is present in a reference to a collective subroutine and its execution is successful, it is assigned the value zero. If the STAT argument is present in a reference to a collective subroutine and an error condition occurs, it is assigned a positive value and the A argument becomes undefined. If the STAT argument is not present in a reference to a collective subroutine and an error condition occurs, error termination is initiated.

ERRMSG shall be a noncoindexed default character scalar. It is an INTENT (INOUT) argument. If the ERRMSG argument is present in a reference to a collective subroutine and an error condition occurs, it is assigned an explanatory message, truncated or padded with blanks if required. If no error condition occurs, the definition status and value of ERRMSG are unchanged.

SEE ALSO

co_max(3), co_min(3), co_sum(3)