<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- Converted with LaTeX2HTML 2018 (Released Feb 1, 2018) -->
< HTML >
< HEAD >
< TITLE > psb_rcv -- Receive data< / TITLE >
< META NAME = "description" CONTENT = "psb_rcv -- Receive data" >
< META NAME = "keywords" CONTENT = "userhtml" >
< META NAME = "resource-type" CONTENT = "document" >
< META NAME = "distribution" CONTENT = "global" >
< META NAME = "Generator" CONTENT = "LaTeX2HTML v2018" >
< META HTTP-EQUIV = "Content-Style-Type" CONTENT = "text/css" >
< LINK REL = "STYLESHEET" HREF = "userhtml.css" >
< LINK REL = "previous" HREF = "node115.html" >
< LINK REL = "up" HREF = "node99.html" >
< LINK REL = "next" HREF = "node117.html" >
< / HEAD >
< BODY >
< DIV CLASS = "navigation" > <!-- Navigation Panel -->
< A NAME = "tex2html1707"
HREF="node117.html">
< IMG WIDTH = "37" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "next" SRC = "next.png" > < / A >
< A NAME = "tex2html1703"
HREF="node99.html">
< IMG WIDTH = "26" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "up" SRC = "up.png" > < / A >
< A NAME = "tex2html1699"
HREF="node115.html">
< IMG WIDTH = "63" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "previous" SRC = "prev.png" > < / A >
< A NAME = "tex2html1705"
HREF="node1.html">
< IMG WIDTH = "65" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "contents" SRC = "contents.png" > < / A >
< BR >
< B > Next:< / B > < A NAME = "tex2html1708"
HREF="node117.html">Error handling< / A >
< B > Up:< / B > < A NAME = "tex2html1704"
HREF="node99.html">Parallel environment routines< / A >
< B > Previous:< / B > < A NAME = "tex2html1700"
HREF="node115.html">psb_snd Send< / A >
< B > < A NAME = "tex2html1706"
HREF="node1.html">Contents< / A > < / B >
< BR >
< BR > < / DIV >
<!-- End of Navigation Panel -->
< H2 > < A NAME = "SECTION000817000000000000000" >
psb_rcv -- Receive data< / A >
< / H2 >
< P >
< PRE >
call psb_rcv(icontxt, dat, src, m)
< / PRE >
< P >
This subroutine receives a packet of data to a destination.
< DL >
< DT > < STRONG > Type:< / STRONG > < / DT >
< DD > Synchronous: see usage notes.
< / DD >
< DT > < STRONG > < B > On Entry < / B > < / STRONG > < / DT >
< DD >
< / DD >
< DT > < STRONG > icontxt< / STRONG > < / DT >
< DD > the communication context identifying the virtual
parallel machine.
< BR >
Scope: < B > global< / B > .
< BR >
Type: < B > required< / B > .
< BR >
Intent: < B > in< / B > .
< BR >
Specified as: an integer variable.
< / DD >
< DT > < STRONG > src< / STRONG > < / DT >
< DD > Source process.
< BR >
Scope: < B > global< / B > .
< BR >
Type: < B > required< / B > .
< BR >
Intent: < B > in< / B > .
< BR >
Specified as: an integer value <!-- MATH
$0< = src < = np-1$
-->
< SPAN CLASS = "MATH" > < IMG
WIDTH="146" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
SRC="img145.png"
ALT="$0< = src < = np-1$">< / SPAN > .
< BR > < / DD >
< DT > < STRONG > m< / STRONG > < / DT >
< DD > Number of rows.
< BR >
Scope: < B > global< / B > .
< BR >
Type: < B > Optional< / B > .
< BR >
Intent: < B > in< / B > .
< BR >
Specified as: an integer value <!-- MATH
$0< = m < = size(dat,1)$
-->
< SPAN CLASS = "MATH" > < IMG
WIDTH="171" HEIGHT="31" ALIGN="MIDDLE" BORDER="0"
SRC="img142.png"
ALT="$0< = m < = size(dat,1)$">< / SPAN > .
< BR >
When < SPAN CLASS = "MATH" > < IMG
WIDTH="26" HEIGHT="15" ALIGN="BOTTOM" BORDER="0"
SRC="img138.png"
ALT="$dat$">< / SPAN > is a rank 2 array, specifies the number of rows to be sent
independently of the leading dimension < SPAN CLASS = "MATH" > < IMG
WIDTH="82" HEIGHT="31" ALIGN="MIDDLE" BORDER="0"
SRC="img143.png"
ALT="$size(dat,1)$">< / SPAN > ; must have the
same value on sending and receiving processes.
< / DD >
< / DL >
< P >
< DL >
< DT > < STRONG > < B > On Return< / B > < / STRONG > < / DT >
< DD >
< / DD >
< DT > < STRONG > dat< / STRONG > < / DT >
< DD > The data to be received.
< BR >
Scope: < B > local< / B > .
< BR >
Type: < B > required< / B > .
< BR >
Intent: < B > inout< / B > .
< BR >
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 and rank must agree on sender and receiver process; if < SPAN CLASS = "MATH" > < IMG
WIDTH="18" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
SRC="img140.png"
ALT="$m$">< / SPAN > is
not specified, size must agree as well.
< / DD >
< / DL >
< P >
< BIG CLASS = "LARGE" > < B > Notes< / B > < / BIG >
< OL >
< LI > This subroutine implies a synchronization, but only between the
calling process and the source process < SPAN CLASS = "MATH" > < IMG
WIDTH="26" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
SRC="img146.png"
ALT="$src$">< / SPAN > .
< / LI >
< / OL >
< P >
< DIV CLASS = "navigation" > < HR >
<!-- Navigation Panel -->
< A NAME = "tex2html1707"
HREF="node117.html">
< IMG WIDTH = "37" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "next" SRC = "next.png" > < / A >
< A NAME = "tex2html1703"
HREF="node99.html">
< IMG WIDTH = "26" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "up" SRC = "up.png" > < / A >
< A NAME = "tex2html1699"
HREF="node115.html">
< IMG WIDTH = "63" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "previous" SRC = "prev.png" > < / A >
< A NAME = "tex2html1705"
HREF="node1.html">
< IMG WIDTH = "65" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "contents" SRC = "contents.png" > < / A >
< BR >
< B > Next:< / B > < A NAME = "tex2html1708"
HREF="node117.html">Error handling< / A >
< B > Up:< / B > < A NAME = "tex2html1704"
HREF="node99.html">Parallel environment routines< / A >
< B > Previous:< / B > < A NAME = "tex2html1700"
HREF="node115.html">psb_snd Send< / A >
< B > < A NAME = "tex2html1706"
HREF="node1.html">Contents< / A > < / B > < / DIV >
<!-- End of Navigation Panel -->
< / BODY >
< / HTML >
