[next] [prev] [prev-tail] [tail] [up]

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

[next] [prev] [prev-tail] [front] [up]