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

ID 767251
Date 3/22/2024
Public

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

Document Table of Contents

IMAGE_STATUS

Elemental Intrinsic Function (Generic): Returns the execution status value of the specified image.

result = IMAGE_STATUS (image [, team])

image

(Input) Must be a positive integer with a value equal to or less than the number of executing images on the specified team.

team

(Input; optional) Must be a scalar of type TEAM_TYPE defined in the intrinsic module ISO_FORTRAN_ENV whose value represents the current or an ancestor team. If not present, the current team is assumed.

Results

The result type is default integer. If image on the specified team has initiated normal termination, the result is the value STAT_STOPPED_IMAGE defined in the intrinsic module ISO_FORTRAN_ENV. If image on the specified team has failed, the result is the value STAT_FAILED_IMAGE defined in the intrinsic module ISO_FORTRAN_ENV. Otherwise, the result value is zero.

Example

If image 5 on the specified team has initiated normal termination, and image 12 on the specified team is known to have failed, then IMAGE_STATUS (5) returns the value STAT_STOPPED_IMAGE and IMAGE_STATUS (12) returns the value STAT_FAILED_IMAGE. If image 3 on the specified team has neither initiated normal termination nor failed, IMAGE_STATUS (3) returns the value zero.