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.