2 Copyright (c) 2000-2014 Ericsson Telecom AB
4 All rights reserved. This program and the accompanying materials
5 are made available under the terms of the Eclipse Public License v1.0
6 which accompanies this distribution, and is available at
7 http://www.eclipse.org/legal/epl-v10.html
11 <meta http-equiv=
"Content-Type" content=
"text/html; charset=utf-8">
12 <meta http-equiv=
"Content-Language" content=
"en-us">
15 <body bgcolor=
"#DAD3C5" vlink=
"#0094D2" link=
"#003258">
16 <table align=
"left" border=
"0" cellspacing=
"0" cellpadding=
"0" valign=top
>
18 <td width=
105 height=
40><a href=
"https://projects.eclipse.org/projects/tools.titan"><img src=
"../images/titan_transparent.gif" border=
0 width=
105 height=
40 align=
"left" alt=
"Titan"></a></td>
21 <table border=
"0" align=
"right" cellpadding=
"0" cellspacing=
"0">
23 <td><a href=
"../titan_main.html" alt=
"contents"><img border=
"0" src=
"../images/ao.jpg" width=
"53" height=
"40"></a></td>
24 <td><a href=
"../titan_index.html" alt=
"index"><img border=
"0" src=
"../images/up.jpg" width=
"53" height=
"40"></a></td>
25 <td><a href=
"self.html" alt=
"previous"><img border=
"0" src=
"../images/left.jpg" width=
"53" height=
"40"></a></td>
26 <td><a href=
"sender.html" alt=
"next"><img border=
"0" src=
"../images/right.jpg" width=
"53" height=
"40"></a></td>
33 <hr align=
"left" width=
"75%">
34 <p>The asynchronous operation belongs to the family of message-based communication operations. It is used to place a value on an outgoing message port.
36 <li>The operation can be used on connected ports.
</li>
37 <li>The operation is non-blocking (does not block TTCN3 program execution).
</li>
38 <li>In case of multiple connections the receiver may be addressed.
</li>
40 <p>Related keywords:
</p>
42 <li><a href=
"address.html"><b><font face=
"Courier New" color=
"#003258" size=
"4">address
</font></b></a></li>
43 <li><a href=
"create.html"><b><font face=
"Courier New" color=
"#003258" size=
"4">create
</font></b></a></li>
44 <li><a href=
"modifies.html"><b><font face=
"Courier New" color=
"#003258" size=
"4">modifies
</font></b></a></li>
45 <li><a href=
"system.html"><b><font face=
"Courier New" color=
"#003258" size=
"4">system
</font></b></a></li>
46 <li><a href=
"to.html"><b><font face=
"Courier New" color=
"#003258" size=
"4">to
</font></b></a></li>
48 <hr align=
"left" width=
"50%">
51 <table border=
"0" width=
"90%" bgcolor=
"#FFB599" cellpadding=
"4">
54 <h3 align=
"center"><i>port_reference
</i><font face=
"Courier New" color=
"#003258" size=
"5"><b>.send (
</b></font><i> value_part
</i><font face=
"Courier New" color=
"#003258" size=
"5"><b>)
55 </b></font>[
<font face=
"Courier New" color=
"#003258" size=
"5"><b>to
</b></font><i>address_reference
</i> ]
<font face=
"Courier New" color=
"#003258" size=
"5"><b>;
</b></font> </h3>
63 <p><i> port_reference
</i> points out the outgoing message port.
</p>
66 <p>The
<b><font face=
"Courier New" color=
"#003258" size=
"4">send
</font> </b> keyword introduces the message sending.
</p>
69 <p><i>value_part
</i> is one of the following:
</p>
71 <li>a literal value, a constant, a variable, an expression. (see the
<a href=
"#Example 1">example1
</a>)
</li>
72 <li>a specific value template (see the
<a href=
"#Example 2">example
2</a>)
</li>
73 <li>a modified template (see the
<a href=
"#Example 3">example
3</a>)
<br>
77 <table border=
"0" width=
"100%" bgcolor=
"#C9C2BB" cellpadding=
"4">
81 <p>The optional
<b><font face=
"Courier New" color=
"#003258" size=
"4">to
</font> </b> keyword is used when a port is connected to several entities and identification of the communication
82 partner is required.
</p>
87 <p><i>address_reference
</i> is one of the following:
</p>
89 <li>a component reference (cf.
<a href=
"create.html"><b><font face=
"Courier New" color=
"#003258" size=
"4">create
</font></b></a>)
or the keyword
<a
90 href=
"system.html" target=
"_blank"><b><font face=
"Courier New" color=
"#003258" size=
"4">system
</font></b></a>, in case of one-to-many connections.
</li>
91 <li>an address reference (cf.
<a href=
"address.html"><b><font face=
"Courier New" color=
"#003258" size=
"4">address
</font></b></a>) , when there are several entities
92 within the system under test.
</li>
96 <hr align=
"left" width=
"50%">
97 <p><a name=
"Example 1">Example
1</a>: literal value
98 <p><font face=
"Courier New">Portus_PCO.send (charstring:
"bla
") to system;
</font>
99 <p>The character string bla is sent over the port Portus_PCO to the test system interface. The port is connected to several components.
</p>
100 <hr align=
"left" width=
"50%">
101 <p><a name=
"Example 2">Example
2</a>: template
</p>
102 <p><font face=
"Courier New">template DefinedRecordType t_MeusTemplate (integer pl_param) := {
<br>
103 field1 :=
16,
<br>
104 field2 := pl_param
<br>
106 <p><font face=
"Courier New">Portus_PCO.send (t_MeusTemplate(
116));
</font></p>
107 <p>The parameterized template (t_MeusTemplate) has two integer fields. When sent as shown in the second line, the values
16 and
116 will be sent to the port Portus_PCO.
</p>
108 <hr align=
"left" width=
"50%">
109 <p><a name=
"Example 3">Example
3</a>: modified template
</p>
110 <p><font face=
"Courier New">Portus_PCO.send (modifies t_MeusTemplate(
116) := {field1 :=
117});
</font></p>
111 <p>The template defined in example
2 is modified. When sent as shown, the values
117 and
116 will be sent to the port Portus_PCO.
</p>
112 <hr align=
"left" width=
"25%">
113 <hr align=
"left" width=
"25%">
114 <p><a HREF=
"BNF.html#sendstatement">BNF definition
</a> of
<font face=
"Courier New"> send
</font></p>