1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
.TH pvm_send 1 "May 1998" "Scilab // Group" "Scilab function"
.so ../sci.an
.SH NAME
pvm_send - immediately sends (or multicast) data.
.SH CALLING SEQUENCE
.nf
[info] = pvm_send(tids,buff,msgtag)
.fi
.SH PARAMETERS
.TP 5
tids
: row of integers, contains the task IDs of the tasks to be sent to.
.TP 4
buff
: scilab variable.
.TP 5
msgtag : integer, message tag supplied by the user. msgtag should be
>= 0. It allows the user's program to distinguish between different
kinds of messages .
.TP 5
info
: integer, status code returned by the routine.
Values less than zero indicate an error.
.SH DESCRIPTION
\fVpvm_send\fR
sends (or multicasts) a message
to the PVM process identified in the
.I tids
array. Note that the message is not sent to the caller even if listed
in the array of tids.
.I msgtag
is used to label the content of the message.
If pvm_send is successful,
.I info
will be 0. If some error occurs then
.I info
will be < 0.
.PP
The pvm_send routine is asynchronous. Computation on the sending
processor resumes as soon as the message is safely on its way to the
receiving processor. This is in contrast to synchronous
communication, during which computation on the sending processor halts
until the matching receive is executed by the receiving processor.
.PP
If a multicast is performed, pvm_send first determines which other
pvmds contain the specified tasks. Then passes the message to these
pvmds which in turn distribute the message to their local tasks
without further network traffic.
.PP
The PVM model guarantees the following about message order. If task 1
sends message A to task 2, then task 1 sends message B to task 2,
message A will arrive at task 2 before message B. Moreover, if both
messages arrive before task 2 does a receive, then a wildcard receive
will always return message A.
.PP
Terminating a PVM task immediately after sending a message or messages
from it may result in those messages being lost. To be sure, always
call pvm_exit() before stopping.
.SH EXAMPLE
.nf
A = rand(5,5)*(1+%i);
deff('[x]=f(y)','x = 1/y')
info = pvm_send([262150, 262152], A(1:2:5,:), 100)
pvm_send(262146,f,200)
.fi
.SH SEE ALSO
pvm_recv, pvm_bcast
|
