coarray, Qcoarray

Enables the coarray feature.

IDE Equivalent

Windows: Language > Enable Coarrays

Linux: None

Mac OS X: None

Architectures

IA-32, Intel® 64 architectures

Syntax

Linux:

-coarray[=memory]

Mac OS X:

None

Windows:

/Qcoarray[:memory]

Arguments

memory

Specifies the memory system where the coarrays will be implemented. Possible values are:

shared	Indicates a shared memory system.
distributed	Indicates a distributed memory system.

Default

OFF	Coarrays are not enabled without specifying this option.

Description

This option enables the coarray feature of the Fortran 2008 Standard. It enables any coarray syntax in your program. If this option is not specified, coarray syntax is rejected.

It also tells the driver to link against appropriate libraries, and to create the appropriate executables.

If you do not specify memory, the default is distributed if the Intel® Cluster Toolkit is installed; otherwise, shared.

You can specify option -coarray-num-images (Linux* OS) or /Qcoarray-num-images (Windows* OS) to specify the default number of images that can be used to run a coarray executable. If you do not specify that option, you get the number of execution units on the current system.

You can specify option -coarray-config-file (Linux* OS) or /Qcoarray-config-file (Windows* OS) to specify the name of a Message Passing Interface (MPI) configuration file.

Options –coarray-num-images and –coarray-config-file (Linux* OS), and options /Qcoarray-num-images and /Qcoarray-config-file (Windows* OS) are valid for both shared and distributed memory systems.

Alternate Options

None

Example

The following command runs a coarray program on shared memory using n images:

/Qcoarray /Qcoarray-num-images:n          ! Windows OS

-coarray -coarray-num-images=n            ! Linux OS

The following command runs a coarray program on distributed memory using n images:

-coarray=distributed -coarray-num-images=n            ! Linux OS

The following command runs a coarray program on shared memory using the MPI configuration file specified by filename:

/Qcoarray:shared /Qcoarray-config-file:filename        ! Windows OS

-coarray=shared -coarray-config-file=filename          ! Linux OS