fdurastante/psblas3
1
0
Fork 0
mirror of https://github.com/sfilippone/psblas3.git synced 2026-10-06 22:55:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document non-blocking collectives.

Browse Source
This commit is contained in:
Salvatore Filippone
2022-03-28 14:04:52 +02:00
parent 1fe2c71163
commit 9c6bb4da99
13 changed files with 3493 additions and 2751 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/html/userhtml29x.png
BIN
View File
Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 2.4 KiB

After

Width:  |  Height:  |  Size: 2.4 KiB

docs/html/userhtmlsu65.html
+53 -7
View File
@@ -22,7 +22,7 @@ href="userhtmlsu59.html#userhtmlsu68.html" >up</a>] </p></div>
<pre class="verbatim" id="verbatim-69">
call&#x00A0;psb_bcast(ctxt,&#x00A0;dat,&#x00A0;root)
call&#x00A0;psb_bcast(ctxt,&#x00A0;dat,&#x00A0;root&#x00A0;[,&#x00A0;mode,&#x00A0;request])
</pre>
<!--l. 284--><p class="nopar" >
<!--l. 286--><p class="indent" > This subroutine implements a broadcast operation based on the underlying
@@ -74,8 +74,41 @@ class="newline" />Specified as: an integer value 0 <span
class="cmmi-10">&#x003C;</span>= <span
class="cmmi-10">root &#x003C;</span>= <span
class="cmmi-10">np </span><span
class="cmsy-10">- </span>1, default 0 &#x00A0;</dd></dl>
<!--l. 313--><p class="indent" >
class="cmsy-10">- </span>1, default 0 &#x00A0;
</dd><dt class="description">
<span
class="cmbx-10">mode</span> </dt><dd
class="description">Whether the call is started in non-blocking mode and completed later,
or is executed fully.<br
class="newline" />Scope: <span
class="cmbx-10">global</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">in</span>.<br
class="newline" />Specified as: an integer, with the value determined by the bitwise OR of
<span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_start_</span></span></span>, <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_end_</span></span></span>. Default: both fields are
selected.<br
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 327--><p class="indent" >
<dl class="description"><dt class="description">
<span
class="cmbx-10">On Return</span> </dt><dd
@@ -83,7 +116,7 @@ class="description">
</dd><dt class="description">
<span
class="cmbx-10">dat</span> </dt><dd
class="description">On processes other than root, the data to be broadcast.<br
class="description">On all processes other than root, the broadcasted data.<br
class="newline" />Scope: <span
class="cmbx-10">global</span>.<br
class="newline" />Type: <span
@@ -92,19 +125,32 @@ class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />Specified as: an integer, real or complex variable, which may be a scalar,
or a rank 1 or 2 array, or a character or logical scalar. &#x00A0;Type, kind, rank
and size must agree on all processes.</dd></dl>
and size must agree on all processes.
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 325--><div class="crosslinks"><p class="noindent">[<a
<!--l. 345--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu69.html" >next</a>] [<a
href="userhtmlsu64.html" >prev</a>] [<a
href="userhtmlsu64.html#tailuserhtmlsu64.html" >prev-tail</a>] [<a
href="userhtmlsu65.html" >front</a>] [<a
href="userhtmlsu59.html#userhtmlsu68.html" >up</a>] </p></div>
<!--l. 325--><p class="indent" > <a
<!--l. 345--><p class="indent" > <a
id="tailuserhtmlsu65.html"></a>
</body></html>
docs/html/userhtmlsu66.html
+53 -13
View File
@@ -10,7 +10,7 @@
<link rel="stylesheet" type="text/css" href="userhtml.css">
</head><body
>
<!--l. 325--><div class="crosslinks"><p class="noindent">[<a
<!--l. 345--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu70.html" >next</a>] [<a
href="userhtmlsu65.html" >prev</a>] [<a
href="userhtmlsu65.html#tailuserhtmlsu65.html" >prev-tail</a>] [<a
@@ -22,10 +22,10 @@ href="userhtmlsu59.html#userhtmlsu69.html" >up</a>] </p></div>
<pre class="verbatim" id="verbatim-70">
call&#x00A0;psb_sum(ctxt,&#x00A0;dat,&#x00A0;root)
call&#x00A0;psb_sum(ctxt,&#x00A0;dat,&#x00A0;root&#x00A0;[,&#x00A0;mode,&#x00A0;request])
</pre>
<!--l. 329--><p class="nopar" >
<!--l. 331--><p class="indent" > This subroutine implements a sum reduction operation based on the underlying
<!--l. 349--><p class="nopar" >
<!--l. 351--><p class="indent" > This subroutine implements a sum reduction operation based on the underlying
communication library.
<dl class="description"><dt class="description">
<span
@@ -74,8 +74,38 @@ class="cmsy-10">-</span>1 <span
class="cmmi-10">&#x003C;</span>= <span
class="cmmi-10">root &#x003C;</span>= <span
class="cmmi-10">np </span><span
class="cmsy-10">- </span>1, default -1. &#x00A0;</dd></dl>
<!--l. 358--><p class="indent" >
class="cmsy-10">- </span>1, default -1. &#x00A0;
</dd><dt class="description">
<span
class="cmbx-10">mode</span> </dt><dd
class="description">Whether the call is started in non-blocking mode and completed later,
or is executed fully.<br
class="newline" />Scope: <span
class="cmbx-10">global</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">in</span>.<br
class="newline" />Specified as: an integer, with the value determined by the bitwise OR of
<span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_start_</span></span></span>, <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_end_</span></span></span>. Default: both fields are
selected.<br
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 392--><p class="indent" >
<dl class="description"><dt class="description">
<span
class="cmbx-10">On Return</span> </dt><dd
@@ -92,12 +122,22 @@ class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />Specified as: an integer, real or complex variable, which may be a scalar,
or a rank 1 or 2 array. <br
class="newline" />Type, kind, rank and size must agree on all processes.</dd></dl>
<!--l. 369--><p class="noindent" ><span
class="newline" />Type, kind, rank and size must agree on all processes.
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 409--><p class="noindent" ><span
class="cmbx-12">Notes</span>
<ol class="enumerate1" >
<li
class="enumerate" id="x78-115002x1">The <span class="obeylines-h"><span class="verb"><span
@@ -113,12 +153,12 @@ class="cmtt-10">dat</span></span></span> argument may also be a long integer sca
<!--l. 379--><div class="crosslinks"><p class="noindent">[<a
<!--l. 419--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu70.html" >next</a>] [<a
href="userhtmlsu65.html" >prev</a>] [<a
href="userhtmlsu65.html#tailuserhtmlsu65.html" >prev-tail</a>] [<a
href="userhtmlsu66.html" >front</a>] [<a
href="userhtmlsu59.html#userhtmlsu69.html" >up</a>] </p></div>
<!--l. 379--><p class="indent" > <a
<!--l. 419--><p class="indent" > <a
id="tailuserhtmlsu66.html"></a>
</body></html>
docs/html/userhtmlsu67.html
+56 -13
View File
@@ -10,7 +10,7 @@
<link rel="stylesheet" type="text/css" href="userhtml.css">
</head><body
>
<!--l. 379--><div class="crosslinks"><p class="noindent">[<a
<!--l. 419--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu71.html" >next</a>] [<a
href="userhtmlsu66.html" >prev</a>] [<a
href="userhtmlsu66.html#tailuserhtmlsu66.html" >prev-tail</a>] [<a
@@ -22,10 +22,10 @@ href="userhtmlsu59.html#userhtmlsu70.html" >up</a>] </p></div>
<pre class="verbatim" id="verbatim-71">
call&#x00A0;psb_max(ctxt,&#x00A0;dat,&#x00A0;root)
call&#x00A0;psb_max(ctxt,&#x00A0;dat,&#x00A0;root&#x00A0;[,&#x00A0;mode,&#x00A0;request])
</pre>
<!--l. 383--><p class="nopar" >
<!--l. 385--><p class="indent" > This subroutine implements a maximum valuereduction operation based on the
<!--l. 423--><p class="nopar" >
<!--l. 425--><p class="indent" > This subroutine implements a maximum valuereduction operation based on the
underlying communication library.
<dl class="description"><dt class="description">
<span
@@ -76,8 +76,41 @@ class="cmmi-10">&#x003C;</span>= <span
class="cmmi-10">root &#x003C;</span>= <span
class="cmmi-10">np </span><span
class="cmsy-10">- </span>1, default -1. <br
class="newline" /></dd></dl>
<!--l. 412--><p class="indent" >
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">mode</span> </dt><dd
class="description">Whether the call is started in non-blocking mode and completed later,
or is executed fully.<br
class="newline" />Scope: <span
class="cmbx-10">global</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">in</span>.<br
class="newline" />Specified as: an integer, with the value determined by the bitwise OR of
<span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_start_</span></span></span>, <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_end_</span></span></span>. Default: both fields are
selected.<br
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 466--><p class="indent" >
<dl class="description"><dt class="description">
<span
class="cmbx-10">On Return</span> </dt><dd
@@ -93,12 +126,22 @@ class="cmbx-10">required</span>.<br
class="newline" />Intent: <span
class="cmbx-10">in</span>.<br
class="newline" />Specified as: an integer or real variable, which may be a scalar, or a rank
1 or 2 array. &#x00A0;Type, kind, rank and size must agree on all processes.</dd></dl>
<!--l. 424--><p class="noindent" ><span
1 or 2 array. &#x00A0;Type, kind, rank and size must agree on all processes.
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 484--><p class="noindent" ><span
class="cmbx-12">Notes</span>
<ol class="enumerate1" >
<li
class="enumerate" id="x79-116002x1">The <span class="obeylines-h"><span class="verb"><span
@@ -114,12 +157,12 @@ class="cmtt-10">dat</span></span></span> argument may also be a long integer sca
<!--l. 432--><div class="crosslinks"><p class="noindent">[<a
<!--l. 492--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu71.html" >next</a>] [<a
href="userhtmlsu66.html" >prev</a>] [<a
href="userhtmlsu66.html#tailuserhtmlsu66.html" >prev-tail</a>] [<a
href="userhtmlsu67.html" >front</a>] [<a
href="userhtmlsu59.html#userhtmlsu70.html" >up</a>] </p></div>
<!--l. 432--><p class="indent" > <a
<!--l. 492--><p class="indent" > <a
id="tailuserhtmlsu67.html"></a>
</body></html>
docs/html/userhtmlsu68.html
+53 -13
View File
@@ -10,7 +10,7 @@
<link rel="stylesheet" type="text/css" href="userhtml.css">
</head><body
>
<!--l. 432--><div class="crosslinks"><p class="noindent">[<a
<!--l. 492--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu72.html" >next</a>] [<a
href="userhtmlsu67.html" >prev</a>] [<a
href="userhtmlsu67.html#tailuserhtmlsu67.html" >prev-tail</a>] [<a
@@ -22,10 +22,10 @@ href="userhtmlsu59.html#userhtmlsu71.html" >up</a>] </p></div>
<pre class="verbatim" id="verbatim-72">
call&#x00A0;psb_min(ctxt,&#x00A0;dat,&#x00A0;root)
call&#x00A0;psb_min(ctxt,&#x00A0;dat,&#x00A0;root&#x00A0;[,&#x00A0;mode,&#x00A0;request])
</pre>
<!--l. 436--><p class="nopar" >
<!--l. 438--><p class="indent" > This subroutine implements a minimum value reduction operation based on the
<!--l. 496--><p class="nopar" >
<!--l. 498--><p class="indent" > This subroutine implements a minimum value reduction operation based on the
underlying communication library.
<dl class="description"><dt class="description">
<span
@@ -75,8 +75,38 @@ class="cmmi-10">&#x003C;</span>= <span
class="cmmi-10">root &#x003C;</span>= <span
class="cmmi-10">np </span><span
class="cmsy-10">- </span>1, default -1. <br
class="newline" /></dd></dl>
<!--l. 465--><p class="indent" >
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">mode</span> </dt><dd
class="description">Whether the call is started in non-blocking mode and completed later,
or is executed fully.<br
class="newline" />Scope: <span
class="cmbx-10">global</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">in</span>.<br
class="newline" />Specified as: an integer, with the value determined by the bitwise OR of
<span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_start_</span></span></span>, <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_end_</span></span></span>. Default: both fields are
selected.<br
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 539--><p class="indent" >
<dl class="description"><dt class="description">
<span
class="cmbx-10">On Return</span> </dt><dd
@@ -93,12 +123,22 @@ class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />Specified as: an integer or real variable, which may be a scalar, or a rank
1 or 2 array. <br
class="newline" />Type, kind, rank and size must agree on all processes.</dd></dl>
<!--l. 477--><p class="noindent" ><span
class="newline" />Type, kind, rank and size must agree on all processes.
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 557--><p class="noindent" ><span
class="cmbx-12">Notes</span>
<ol class="enumerate1" >
<li
class="enumerate" id="x80-117002x1">The <span class="obeylines-h"><span class="verb"><span
@@ -114,12 +154,12 @@ class="cmtt-10">dat</span></span></span> argument may also be a long integer sca
<!--l. 485--><div class="crosslinks"><p class="noindent">[<a
<!--l. 565--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu72.html" >next</a>] [<a
href="userhtmlsu67.html" >prev</a>] [<a
href="userhtmlsu67.html#tailuserhtmlsu67.html" >prev-tail</a>] [<a
href="userhtmlsu68.html" >front</a>] [<a
href="userhtmlsu59.html#userhtmlsu71.html" >up</a>] </p></div>
<!--l. 485--><p class="indent" > <a
<!--l. 565--><p class="indent" > <a
id="tailuserhtmlsu68.html"></a>
</body></html>
docs/html/userhtmlsu69.html
+53 -13
View File
@@ -10,7 +10,7 @@
<link rel="stylesheet" type="text/css" href="userhtml.css">
</head><body
>
<!--l. 485--><div class="crosslinks"><p class="noindent">[<a
<!--l. 565--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu73.html" >next</a>] [<a
href="userhtmlsu68.html" >prev</a>] [<a
href="userhtmlsu68.html#tailuserhtmlsu68.html" >prev-tail</a>] [<a
@@ -22,10 +22,10 @@ href="userhtmlsu59.html#userhtmlsu72.html" >up</a>] </p></div>
<pre class="verbatim" id="verbatim-73">
call&#x00A0;psb_amx(ctxt,&#x00A0;dat,&#x00A0;root)
call&#x00A0;psb_amx(ctxt,&#x00A0;dat,&#x00A0;root&#x00A0;[,&#x00A0;mode,&#x00A0;request])
</pre>
<!--l. 489--><p class="nopar" >
<!--l. 491--><p class="indent" > This subroutine implements a maximum absolute value reduction operation based
<!--l. 569--><p class="nopar" >
<!--l. 571--><p class="indent" > This subroutine implements a maximum absolute value reduction operation based
on the underlying communication library.
<dl class="description"><dt class="description">
<span
@@ -75,8 +75,38 @@ class="cmmi-10">&#x003C;</span>= <span
class="cmmi-10">root &#x003C;</span>= <span
class="cmmi-10">np </span><span
class="cmsy-10">- </span>1, default -1. <br
class="newline" /></dd></dl>
<!--l. 518--><p class="indent" >
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">mode</span> </dt><dd
class="description">Whether the call is started in non-blocking mode and completed later,
or is executed fully.<br
class="newline" />Scope: <span
class="cmbx-10">global</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">in</span>.<br
class="newline" />Specified as: an integer, with the value determined by the bitwise OR of
<span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_start_</span></span></span>, <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_end_</span></span></span>. Default: both fields are
selected.<br
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 612--><p class="indent" >
<dl class="description"><dt class="description">
<span
class="cmbx-10">On Return</span> </dt><dd
@@ -92,12 +122,22 @@ class="cmbx-10">required</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />Specified as: an integer, real or complex variable, which may be a scalar, or
a rank 1 or 2 array. &#x00A0;Type, kind, rank and size must agree on all processes.</dd></dl>
<!--l. 530--><p class="noindent" ><span
a rank 1 or 2 array. &#x00A0;Type, kind, rank and size must agree on all processes.
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 630--><p class="noindent" ><span
class="cmbx-12">Notes</span>
<ol class="enumerate1" >
<li
class="enumerate" id="x81-118002x1">The <span class="obeylines-h"><span class="verb"><span
@@ -113,12 +153,12 @@ class="cmtt-10">dat</span></span></span> argument may also be a long integer sca
<!--l. 538--><div class="crosslinks"><p class="noindent">[<a
<!--l. 638--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu73.html" >next</a>] [<a
href="userhtmlsu68.html" >prev</a>] [<a
href="userhtmlsu68.html#tailuserhtmlsu68.html" >prev-tail</a>] [<a
href="userhtmlsu69.html" >front</a>] [<a
href="userhtmlsu59.html#userhtmlsu72.html" >up</a>] </p></div>
<!--l. 538--><p class="indent" > <a
<!--l. 638--><p class="indent" > <a
id="tailuserhtmlsu69.html"></a>
</body></html>
docs/html/userhtmlsu70.html
+53 -13
View File
@@ -10,7 +10,7 @@
<link rel="stylesheet" type="text/css" href="userhtml.css">
</head><body
>
<!--l. 538--><div class="crosslinks"><p class="noindent">[<a
<!--l. 638--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlse8.html" >next</a>] [<a
href="userhtmlsu69.html" >prev</a>] [<a
href="userhtmlsu69.html#tailuserhtmlsu69.html" >prev-tail</a>] [<a
@@ -22,10 +22,10 @@ href="userhtmlsu59.html#userhtmlsu73.html" >up</a>] </p></div>
<pre class="verbatim" id="verbatim-74">
call&#x00A0;psb_amn(ctxt,&#x00A0;dat,&#x00A0;root)
call&#x00A0;psb_amn(ctxt,&#x00A0;dat,&#x00A0;root&#x00A0;[,&#x00A0;mode,&#x00A0;request])
</pre>
<!--l. 542--><p class="nopar" >
<!--l. 544--><p class="indent" > This subroutine implements a minimum absolute value reduction operation based
<!--l. 642--><p class="nopar" >
<!--l. 644--><p class="indent" > This subroutine implements a minimum absolute value reduction operation based
on the underlying communication library.
<dl class="description"><dt class="description">
<span
@@ -75,8 +75,38 @@ class="cmmi-10">&#x003C;</span>= <span
class="cmmi-10">root &#x003C;</span>= <span
class="cmmi-10">np </span><span
class="cmsy-10">- </span>1, default -1. <br
class="newline" /></dd></dl>
<!--l. 571--><p class="indent" >
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">mode</span> </dt><dd
class="description">Whether the call is started in non-blocking mode and completed later,
or is executed fully.<br
class="newline" />Scope: <span
class="cmbx-10">global</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">in</span>.<br
class="newline" />Specified as: an integer, with the value determined by the bitwise OR of
<span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_start_</span></span></span>, <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_end_</span></span></span>. Default: both fields are
selected.<br
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 685--><p class="indent" >
<dl class="description"><dt class="description">
<span
class="cmbx-10">On Return</span> </dt><dd
@@ -93,12 +123,22 @@ class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />Specified as: an integer, real or complex variable, which may be a scalar,
or a rank 1 or 2 array. <br
class="newline" />Type, kind, rank and size must agree on all processes.</dd></dl>
<!--l. 583--><p class="noindent" ><span
class="newline" />Type, kind, rank and size must agree on all processes.
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 703--><p class="noindent" ><span
class="cmbx-12">Notes</span>
<ol class="enumerate1" >
<li
class="enumerate" id="x82-119002x1">The <span class="obeylines-h"><span class="verb"><span
@@ -114,12 +154,12 @@ class="cmtt-10">dat</span></span></span> argument may also be a long integer sca
<!--l. 591--><div class="crosslinks"><p class="noindent">[<a
<!--l. 711--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlse8.html" >next</a>] [<a
href="userhtmlsu69.html" >prev</a>] [<a
href="userhtmlsu69.html#tailuserhtmlsu69.html" >prev-tail</a>] [<a
href="userhtmlsu70.html" >front</a>] [<a
href="userhtmlsu59.html#userhtmlsu73.html" >up</a>] </p></div>
<!--l. 591--><p class="indent" > <a
<!--l. 711--><p class="indent" > <a
id="tailuserhtmlsu70.html"></a>
</body></html>
docs/html/userhtmlsu71.html
+54 -14
View File
@@ -10,7 +10,7 @@
<link rel="stylesheet" type="text/css" href="userhtml.css">
</head><body
>
<!--l. 591--><div class="crosslinks"><p class="noindent">[<a
<!--l. 711--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu74.html" >next</a>] [<a
href="userhtmlsu70.html" >prev</a>] [<a
href="userhtmlsu70.html#tailuserhtmlsu70.html" >prev-tail</a>] [<a
@@ -22,10 +22,10 @@ href="userhtmlsu59.html#userhtmlse8.html" >up</a>] </p></div>
<pre class="verbatim" id="verbatim-75">
call&#x00A0;psb_nrm2(ctxt,&#x00A0;dat,&#x00A0;root)
call&#x00A0;psb_nrm2(ctxt,&#x00A0;dat,&#x00A0;root&#x00A0;[,&#x00A0;mode,&#x00A0;request])
</pre>
<!--l. 595--><p class="nopar" >
<!--l. 597--><p class="indent" > This subroutine implements a 2-norm value reduction operation based on the
<!--l. 715--><p class="nopar" >
<!--l. 717--><p class="indent" > This subroutine implements a 2-norm value reduction operation based on the
underlying communication library.
<dl class="description"><dt class="description">
<span
@@ -75,8 +75,38 @@ class="cmmi-10">&#x003C;</span>= <span
class="cmmi-10">root &#x003C;</span>= <span
class="cmmi-10">np </span><span
class="cmsy-10">- </span>1, default -1. <br
class="newline" /></dd></dl>
<!--l. 624--><p class="indent" >
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">mode</span> </dt><dd
class="description">Whether the call is started in non-blocking mode and completed later,
or is executed fully.<br
class="newline" />Scope: <span
class="cmbx-10">global</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">in</span>.<br
class="newline" />Specified as: an integer, with the value determined by the bitwise OR of
<span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_start_</span></span></span>, <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">psb_collective_end_</span></span></span>. Default: both fields are
selected.<br
class="newline" />
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 758--><p class="indent" >
<dl class="description"><dt class="description">
<span
class="cmbx-10">On Return</span> </dt><dd
@@ -92,12 +122,22 @@ class="cmbx-10">required</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />Specified as: a real variable, which may be a scalar, or a rank 1 array. <br
class="newline" />Kind, rank and size must agree on all processes.</dd></dl>
<!--l. 636--><p class="noindent" ><span
class="newline" />Kind, rank and size must agree on all processes.
</dd><dt class="description">
<span
class="cmbx-10">request</span> </dt><dd
class="description">A request variable to check for operation completion.<br
class="newline" />Scope: <span
class="cmbx-10">local</span>.<br
class="newline" />Type: <span
class="cmbx-10">optional</span>.<br
class="newline" />Intent: <span
class="cmbx-10">inout</span>.<br
class="newline" />If <span class="obeylines-h"><span class="verb"><span
class="cmtt-10">mode</span></span></span> does not specifies immediate completion, then this variable must
be present.</dd></dl>
<!--l. 776--><p class="noindent" ><span
class="cmbx-12">Notes</span>
<ol class="enumerate1" >
<li
class="enumerate" id="x83-120002x1">This reduction is appropriate to compute the results of multiple (local)
@@ -118,7 +158,7 @@ src="userhtml29x.png" alt=" &#x2218; -------
res = dati,
i
" class="math-display" ></center>
<!--l. 642--><p class="nopar" > with care taken to avoid unnecessary overflow.
<!--l. 782--><p class="nopar" > with care taken to avoid unnecessary overflow.
</li>
<li
class="enumerate" id="x83-120006x3">The <span class="obeylines-h"><span class="verb"><span
@@ -130,12 +170,12 @@ class="cmtt-10">dat</span></span></span> argument is both input and output, and
<!--l. 651--><div class="crosslinks"><p class="noindent">[<a
<!--l. 791--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu74.html" >next</a>] [<a
href="userhtmlsu70.html" >prev</a>] [<a
href="userhtmlsu70.html#tailuserhtmlsu70.html" >prev-tail</a>] [<a
href="userhtmlsu71.html" >front</a>] [<a
href="userhtmlsu59.html#userhtmlse8.html" >up</a>] </p></div>
<!--l. 651--><p class="indent" > <a
<!--l. 791--><p class="indent" > <a
id="tailuserhtmlsu71.html"></a>
</body></html>
docs/html/userhtmlsu72.html
+7 -7
View File
@@ -10,7 +10,7 @@
<link rel="stylesheet" type="text/css" href="userhtml.css">
</head><body
>
<!--l. 651--><div class="crosslinks"><p class="noindent">[<a
<!--l. 791--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu75.html" >next</a>] [<a
href="userhtmlsu71.html" >prev</a>] [<a
href="userhtmlsu71.html#tailuserhtmlsu71.html" >prev-tail</a>] [<a
@@ -24,8 +24,8 @@ href="userhtmlsu59.html#userhtmlsu74.html" >up</a>] </p></div>
<pre class="verbatim" id="verbatim-76">
call&#x00A0;psb_snd(ctxt,&#x00A0;dat,&#x00A0;dst,&#x00A0;m)
</pre>
<!--l. 655--><p class="nopar" >
<!--l. 657--><p class="indent" > This subroutine sends a packet of data to a destination.
<!--l. 795--><p class="nopar" >
<!--l. 797--><p class="indent" > This subroutine sends a packet of data to a destination.
<dl class="description"><dt class="description">
<span
class="cmbx-10">Type:</span> </dt><dd
@@ -97,7 +97,7 @@ class="cmmi-10">dat </span>is a rank 2 array, specifies the number of r
class="cmmi-10">size</span>(<span
class="cmmi-10">dat,</span>1); must have the same
value on sending and receiving processes.</dd></dl>
<!--l. 691--><p class="indent" >
<!--l. 831--><p class="indent" >
<dl class="description"><dt class="description">
<span
class="cmbx-10">On Return</span> </dt><dd
@@ -105,7 +105,7 @@ class="description"></dd></dl>
<!--l. 695--><p class="noindent" ><span
<!--l. 835--><p class="noindent" ><span
class="cmbx-12">Notes</span>
<ol class="enumerate1" >
<li
@@ -118,12 +118,12 @@ class="cmmi-10">dst</span>.</li></ol>
<!--l. 702--><div class="crosslinks"><p class="noindent">[<a
<!--l. 842--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu75.html" >next</a>] [<a
href="userhtmlsu71.html" >prev</a>] [<a
href="userhtmlsu71.html#tailuserhtmlsu71.html" >prev-tail</a>] [<a
href="userhtmlsu72.html" >front</a>] [<a
href="userhtmlsu59.html#userhtmlsu74.html" >up</a>] </p></div>
<!--l. 702--><p class="indent" > <a
<!--l. 842--><p class="indent" > <a
id="tailuserhtmlsu72.html"></a>
</body></html>
docs/html/userhtmlsu73.html
+5 -5
View File
@@ -10,7 +10,7 @@
<link rel="stylesheet" type="text/css" href="userhtml.css">
</head><body
>
<!--l. 702--><div class="crosslinks"><p class="noindent">[<a
<!--l. 842--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu72.html" >prev</a>] [<a
href="userhtmlsu72.html#tailuserhtmlsu72.html" >prev-tail</a>] [<a
href="userhtmlsu70.html#tailuserhtmlsu73.html">tail</a>] [<a
@@ -23,8 +23,8 @@ href="userhtmlsu59.html#userhtmlsu75.html" >up</a>] </p></div>
<pre class="verbatim" id="verbatim-77">
call&#x00A0;psb_rcv(ctxt,&#x00A0;dat,&#x00A0;src,&#x00A0;m)
</pre>
<!--l. 706--><p class="nopar" >
<!--l. 708--><p class="indent" > This subroutine receives a packet of data to a destination.
<!--l. 846--><p class="nopar" >
<!--l. 848--><p class="indent" > This subroutine receives a packet of data to a destination.
<dl class="description"><dt class="description">
<span
class="cmbx-10">Type:</span> </dt><dd
@@ -81,7 +81,7 @@ class="cmmi-10">dat </span>is a rank 2 array, specifies the number of r
class="cmmi-10">size</span>(<span
class="cmmi-10">dat,</span>1); must have the same
value on sending and receiving processes.</dd></dl>
<!--l. 734--><p class="indent" >
<!--l. 874--><p class="indent" >
<dl class="description"><dt class="description">
<span
class="cmbx-10">On Return</span> </dt><dd
@@ -104,7 +104,7 @@ class="cmmi-10">m </span>is not specified, size
<!--l. 746--><p class="noindent" ><span
<!--l. 886--><p class="noindent" ><span
class="cmbx-12">Notes</span>
<ol class="enumerate1" >
<li
docs/html/userhtmlsu90.html
+4
View File
@@ -388,6 +388,10 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
<!--l. 124--><p class="indent" >
<!--l. 2--><div class="crosslinks"><p class="noindent">[<a
href="userhtmlsu90.html" >front</a>] [<a
href="# " >up</a>] </p></div>
docs/psblas-3.7.pdf
+2954 -2645
View File
File diff suppressed because it is too large Load Diff
docs/src/penv.tex
+148 -8
View File
@@ -280,7 +280,7 @@ Specified as: an integer variable.
\clearpage\subsection{psb\_bcast --- Broadcast data}
\begin{verbatim}
call psb_bcast(ctxt, dat, root)
call psb_bcast(ctxt, dat, root [, mode, request])
\end{verbatim}
This subroutine implements a broadcast operation based on the
@@ -307,25 +307,45 @@ Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer value $0<= root <= np-1$, default 0 \
\item[mode] Whether the call is started in non-blocking mode and completed
later, or is executed fully.\\
Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer, with the value determined by the bitwise OR
of \verb|psb_collective_start_|, \verb|psb_collective_end_|.
Default: both fields are selected.\\
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
\begin{description}
\item[\bf On Return]
\item[dat] On processes other than root, the data to be broadcast.\\
\item[dat] On all processes other than root, the broadcasted data.\\
Scope: {\bf global}.\\
Type: {\bf required}.\\
Intent: {\bf inout}.\\
Specified as: an integer, real or complex variable, which may be a
scalar, or a rank 1 or 2 array, or a character or logical scalar. \
Type, kind, rank and size must agree on all processes.
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
\clearpage\subsection{psb\_sum --- Global sum}
\begin{verbatim}
call psb_sum(ctxt, dat, root)
call psb_sum(ctxt, dat, root [, mode, request])
\end{verbatim}
This subroutine implements a sum reduction operation based on the
@@ -352,6 +372,20 @@ Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer value $-1<= root <= np-1$, default -1. \
\item[mode] Whether the call is started in non-blocking mode and completed
later, or is executed fully.\\
Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer, with the value determined by the bitwise OR
of \verb|psb_collective_start_|, \verb|psb_collective_end_|.
Default: both fields are selected.\\
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
@@ -364,6 +398,12 @@ Intent: {\bf inout}.\\
Specified as: an integer, real or complex variable, which may be a
scalar, or a rank 1 or 2 array. \\
Type, kind, rank and size must agree on all processes.
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
{\par\noindent\large\bfseries Notes}
@@ -379,7 +419,7 @@ Type, kind, rank and size must agree on all processes.
\clearpage\subsection{psb\_max --- Global maximum}
\begin{verbatim}
call psb_max(ctxt, dat, root)
call psb_max(ctxt, dat, root [, mode, request])
\end{verbatim}
This subroutine implements a maximum valuereduction
@@ -406,6 +446,20 @@ Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer value $-1<= root <= np-1$, default -1. \\
\item[mode] Whether the call is started in non-blocking mode and completed
later, or is executed fully.\\
Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer, with the value determined by the bitwise OR
of \verb|psb_collective_start_|, \verb|psb_collective_end_|.
Default: both fields are selected.\\
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
@@ -418,6 +472,12 @@ Intent: {\bf in}.\\
Specified as: an integer or real variable, which may be a
scalar, or a rank 1 or 2 array. \
Type, kind, rank and size must agree on all processes.
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
@@ -432,7 +492,7 @@ Type, kind, rank and size must agree on all processes.
\clearpage\subsection{psb\_min --- Global minimum}
\begin{verbatim}
call psb_min(ctxt, dat, root)
call psb_min(ctxt, dat, root [, mode, request])
\end{verbatim}
This subroutine implements a minimum value reduction
@@ -459,6 +519,20 @@ Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer value $-1<= root <= np-1$, default -1. \\
\item[mode] Whether the call is started in non-blocking mode and completed
later, or is executed fully.\\
Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer, with the value determined by the bitwise OR
of \verb|psb_collective_start_|, \verb|psb_collective_end_|.
Default: both fields are selected.\\
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
@@ -471,6 +545,12 @@ Intent: {\bf inout}.\\
Specified as: an integer or real variable, which may be a
scalar, or a rank 1 or 2 array. \\
Type, kind, rank and size must agree on all processes.
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
@@ -485,7 +565,7 @@ Type, kind, rank and size must agree on all processes.
\clearpage\subsection{psb\_amx --- Global maximum absolute value}
\begin{verbatim}
call psb_amx(ctxt, dat, root)
call psb_amx(ctxt, dat, root [, mode, request])
\end{verbatim}
This subroutine implements a maximum absolute value reduction
@@ -512,6 +592,20 @@ Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer value $-1<= root <= np-1$, default -1. \\
\item[mode] Whether the call is started in non-blocking mode and completed
later, or is executed fully.\\
Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer, with the value determined by the bitwise OR
of \verb|psb_collective_start_|, \verb|psb_collective_end_|.
Default: both fields are selected.\\
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
@@ -524,6 +618,12 @@ Intent: {\bf inout}.\\
Specified as: an integer, real or complex variable, which may be a
scalar, or a rank 1 or 2 array. \
Type, kind, rank and size must agree on all processes.
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
@@ -538,7 +638,7 @@ Type, kind, rank and size must agree on all processes.
\clearpage\subsection{psb\_amn --- Global minimum absolute value}
\begin{verbatim}
call psb_amn(ctxt, dat, root)
call psb_amn(ctxt, dat, root [, mode, request])
\end{verbatim}
This subroutine implements a minimum absolute value reduction
@@ -565,6 +665,20 @@ Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer value $-1<= root <= np-1$, default -1. \\
\item[mode] Whether the call is started in non-blocking mode and completed
later, or is executed fully.\\
Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer, with the value determined by the bitwise OR
of \verb|psb_collective_start_|, \verb|psb_collective_end_|.
Default: both fields are selected.\\
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
@@ -577,6 +691,12 @@ Intent: {\bf inout}.\\
Specified as: an integer, real or complex variable, which may be a
scalar, or a rank 1 or 2 array. \\
Type, kind, rank and size must agree on all processes.
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
@@ -591,7 +711,7 @@ Type, kind, rank and size must agree on all processes.
\clearpage\subsection{psb\_nrm2 --- Global 2-norm reduction}
\begin{verbatim}
call psb_nrm2(ctxt, dat, root)
call psb_nrm2(ctxt, dat, root [, mode, request])
\end{verbatim}
This subroutine implements a 2-norm value reduction
@@ -618,6 +738,20 @@ Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer value $-1<= root <= np-1$, default -1. \\
\item[mode] Whether the call is started in non-blocking mode and completed
later, or is executed fully.\\
Scope: {\bf global}.\\
Type: {\bf optional}.\\
Intent: {\bf in}.\\
Specified as: an integer, with the value determined by the bitwise OR
of \verb|psb_collective_start_|, \verb|psb_collective_end_|.
Default: both fields are selected.\\
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}
@@ -630,6 +764,12 @@ Intent: {\bf inout}.\\
Specified as: a real variable, which may be a
scalar, or a rank 1 array. \\
Kind, rank and size must agree on all processes.
\item[request] A request variable to check for operation completion.\\
Scope: {\bf local}.\\
Type: {\bf optional}.\\
Intent: {\bf inout}.\\
If \verb|mode| does not specifies immediate completion, then this
variable must be present.
\end{description}