1SEND(3PVM)                      PVM Version 3.4                     SEND(3PVM)
2
3
4

NAME

6       pvm_send - Immediately sends the data in the active message buffer.
7
8

SYNOPSIS

10       C    int info = pvm_send( int tid, int msgtag )
11
12       Fortran   call pvmfsend( tid, msgtag, info )
13
14

PARAMETERS

16       tid     Integer task identifier of destination process.
17
18       msgtag  Integer  message tag supplied by the user.  msgtag should be >=
19               0.
20
21       info    Integer status code returned by the routine.
22
23

DESCRIPTION

25       The routine pvm_send sends a message stored in the active  send  buffer
26       to the PVM process identified by tid.  msgtag is used to label the con‐
27       tent of the message.  If pvm_send is successful, info  will  be  0.  If
28       some error occurs then info will be < 0.
29
30       The  pvm_send routine is asynchronous.  Computation on the sending pro‐
31       cessor resumes as soon as the message is  safely  on  its  way  to  the
32       receiving processor.  This is in contrast to synchronous communication,
33       during which computation on  the  sending  processor  halts  until  the
34       matching receive is executed by the receiving processor.
35
36       The  PVM model guarantees the following about message order.  If task 1
37       sends message A to task 2, then task 1 sends message B to task 2,  mes‐
38       sage  A will arrive at task 2 before message B.  Moreover, if both mes‐
39       sages arrive before task 2 does a receive, then a wildcard receive will
40       always return message A.
41
42       Terminating  a PVM task immediately after sending a message or messages
43       from it may result in those messages being lost.  To  be  sure,  always
44       call pvm_exit() before stopping.
45
46

EXAMPLES

48       C:
49            info = pvm_initsend( PvmDataDefault );
50            info = pvm_pkint( array, 10, 1 );
51            msgtag = 3 ;
52            info = pvm_send( tid, msgtag );
53
54       Fortran:
55            CALL PVMFINITSEND(PVMRAW, INFO)
56            CALL PVMFPACK( REAL8, DATA, 100, 1, INFO )
57            CALL PVMFSEND( TID, 3, INFO )
58
59

ERRORS

61       These error conditions can be returned by pvm_send
62
63       PvmBadParam
64              giving an invalid tid or a msgtag.
65
66       PvmSysErr
67              pvmd not responding.
68
69       PvmNoBuf
70              no active send buffer. Try pvm_initsend() before send.
71

SEE ALSO

73       pvm_initsend(3PVM),  pvm_mcast(3PVM),  pvm_pack(3PVM), pvm_psend(3PVM),
74       pvm_recv(3PVM)
75
76
77
78                                30 August, 1993                     SEND(3PVM)
Impressum