FAIL IMAGE statement

Standard: F77 F90 F95 F2003 F2008 F2018

---

＜Syntax＞

FAIL IMAGE

＜Semantics＞

A FAIL IMAGE statement causes the executing image to cease participating in program execution without initiating normal termination or error termination. The purpose of this statement is to facilitate testing of fault tolerant programs, by artificially causing some images to fail.

Attempting to read data from a coarray on a failed image produces incorrect results. Attempting to write data to a coarray on a failed image is ineffective. In either case, if the image selector has a STAT= specifier, the STAT= variable will be assigned the value of STAT_FAILED_IMAGE from the intrinsic module ISO_FORTRAN_ENV.

If all images have failed or stopped, the program will terminate.

＜Related＞

CODIMENSION attribute, Image selectors, STAT= specifier