# 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.

Parent topic: H to I

## See Also

FAILED_IMAGES
STOPPED_IMAGES
ISO_FORTRAN_ENV Module