6.17 psb_glob_to_loc — Global to local indices convertion

call psb_glob_to_loc(x, y, desc_a, info, iact,owned)
call psb_glob_to_loc(x, desc_a, info, iact,owned)

Type:

Asynchronous.

On Entry

x

An integer vector of indices to be converted.
Scope: local
Type: required
Intent: in, inout.
Specified as: a rank one integer array.

desc_a

the communication descriptor.
Scope:local.
Type:required.
Intent: in.
Specified as: a structured data of type psb_desc_type.

iact

specifies action to be taken in case of range errors. Scope: global
Type: optional
Intent: in.
Specified as: a character variable Ignore, Warning or Abort, default Ignore.

owned

Specfies valid range of input Scope: global
Type: optional
Intent: in.
If true, then only indices strictly owned by the current process are considered valid, if false then halo indices are also accepted. Default: false.

On Return

x

If y is not present, then x is overwritten with the translated integer indices. Scope: global
Type: required
Intent: inout.
Specified as: a rank one integer array.

y

If y is present, then y is overwritten with the translated integer indices, and x is left unchanged. Scope: global
Type: optional
Intent: out.
Specified as: a rank one integer array.

info

Error code.
Scope: local
Type: required
Intent: out.
An integer value; 0 means no error has been detected.

Notes

1. If an input index is out of range, then the corresponding output index is set to a negative number;
2. The default Ignore means that the negative output is the only action taken on an out-of-range input.