help/info/send.html

   1 <!--
   2  Copyright (c) 2000-2016 Ericsson Telecom AB
   3  All rights reserved. This program and the accompanying materials
   4  are made available under the terms of the Eclipse Public License v1.0
   5  which accompanies this distribution, and is available at
   6  http://www.eclipse.org/legal/epl-v10.html
   7
   8  Contributors:
   9   Baji, Laszlo
  10   Balasko, Jeno
  11   Farkas, Laszlo
  12   Gecse, Roland
  13   Szabados, Kristof
  14   Szabo, Janos Zoltan – initial implementation
  15 -->
  16 <html>
  17 <head>
  18 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  19 <meta http-equiv="Content-Language" content="en-us">
  20 <title>send</title>
  21 </head>
  22 <body bgcolor="#DAD3C5" vlink="#0094D2" link="#003258">
  23 <table align="left" border="0" cellspacing="0" cellpadding="0" valign=top>
  24   <tr>
  25     <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>
  26   </tr>
  27 </table>
  28 <table border="0" align="right" cellpadding="0" cellspacing="0">
  29   <tr>
  30     <td><a href="../titan_main.html" alt="contents"><img border="0" src="../images/ao.jpg" width="53" height="40"></a></td>
  31     <td><a href="../titan_index.html" alt="index"><img border="0" src="../images/up.jpg" width="53" height="40"></a></td>
  32     <td><a href="self.html" alt="previous"><img border="0" src="../images/left.jpg" width="53" height="40"></a></td>
  33     <td><a href="sender.html" alt="next"><img border="0" src="../images/right.jpg" width="53" height="40"></a></td>
  34   </tr>
  35 </table>
  36 <p><br clear="all">
  37 </p>
  38 <hr>
  39 <h1>send</h1>
  40 <hr align="left" width="75%">
  41 <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.
  42 <ul>
  43   <li>The operation can be used on connected ports.</li>
  44   <li>The operation is non-blocking (does not block TTCN3 program execution).</li>
  45   <li>In case of multiple connections the receiver may be addressed.</li>
  46 </ul>
  47 <p>Related keywords:</p>
  48 <ul>
  49   <li><a href="address.html"><b><font face="Courier New" color="#003258" size="4">address</font></b></a></li>
  50   <li><a href="create.html"><b><font face="Courier New" color="#003258" size="4">create</font></b></a></li>
  51   <li><a href="modifies.html"><b><font face="Courier New" color="#003258" size="4">modifies</font></b></a></li>
  52   <li><a href="system.html"><b><font face="Courier New" color="#003258" size="4">system</font></b></a></li>
  53   <li><a href="to.html"><b><font face="Courier New" color="#003258" size="4">to</font></b></a></li>
  54 </ul>
  55 <hr align="left" width="50%">
  56 <div align="center">
  57 <center>
  58 <table border="0" width="90%" bgcolor="#FFB599" cellpadding="4">
  59   <tr>
  60     <td width="100%">
  61     <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>)
  62     </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> &nbsp;</h3>
  63     </td>
  64   </tr>
  65 </table>
  66 </center>
  67 </div>
  68 <ul>
  69   <li>
  70   <p><i> port_reference</i> points out the outgoing message port.</p>
  71   </li>
  72   <li>
  73   <p>The <b><font face="Courier New" color="#003258" size="4">send</font> </b> keyword introduces the message sending.</p>
  74   </li>
  75   <li>
  76   <p><i>value_part</i> is one of the following:</p>
  77   <ul>
  78     <li>a literal value, a constant, a variable, an expression. (see the <a href="#Example 1">example1</a>)</li>
  79     <li>a specific value template (see the <a href="#Example 2">example 2</a>)</li>
  80     <li>a modified template (see the <a href="#Example 3">example 3</a>)<br>
  81     &nbsp;</li>
  82   </ul>
  83   </li>
  84   <table border="0" width="100%" bgcolor="#C9C2BB" cellpadding="4">
  85     <tr>
  86       <td width="100%">
  87       <li>
  88       <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
  89       partner is required.</p>
  90       </li>
  91       </ul>
  92       <ul>
  93         <li>
  94         <p><i>address_reference</i> is one of the following:</p>
  95         <ul>
  96           <li>a component reference (cf. <a href="create.html"><b><font face="Courier New" color="#003258" size="4">create</font></b></a>)&nbsp; or the keyword <a
  97             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>
  98           <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
  99           within the system under test.</li>
 100         </ul>
 101         </li>
 102       </ul>
 103       <hr align="left" width="50%">
 104       <p><a name="Example 1">Example 1</a>: literal value
 105       <p><font face="Courier New">Portus_PCO.send (charstring:&quot;bla&quot;) to system;</font>
 106       <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>
 107       <hr align="left" width="50%">
 108       <p><a name="Example 2">Example 2</a>: template</p>
 109       <p><font face="Courier New">template DefinedRecordType t_MeusTemplate (integer pl_param) := {<br>
 110       &nbsp;&nbsp;&nbsp;field1 := 16,<br>
 111       &nbsp;&nbsp;&nbsp;field2 := pl_param<br>
 112       }</font>
 113       <p><font face="Courier New">Portus_PCO.send (t_MeusTemplate(116));</font></p>
 114       <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>
 115       <hr align="left" width="50%">
 116       <p><a name="Example 3">Example 3</a>: modified template</p>
 117       <p><font face="Courier New">Portus_PCO.send (modifies t_MeusTemplate(116) := {field1 := 117});</font></p>
 118       <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>
 119       <hr align="left" width="25%">
 120       <hr align="left" width="25%">
 121       <p><a HREF="BNF.html#sendstatement">BNF definition</a> of <font face="Courier New"> send</font></p>
 122 </body>
 123 </html>