macro/command/wait4all.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  <title>wait4all</title>
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="stylesheet" href="../../style.css" type="text/css">
</head>

<body>


<h1>wait4all</h1>

<p>
Waits string for all macro linked terminals. <em>(version 4.63 or later)</em>
</p>

<pre class="macro-syntax">
wait4all &lt;string1&gt; [&lt;string2&gt; ...]
</pre>

<h2>Remarks</h2>

<p>

Pauses until one of the character strings for all macro linked terminals at the time of executing this command is received from the host, or until the timeout occurs. Maximum number of the strings is 10.<br>
The command does not watch the terminal executed after the command and the macro not-linked terminal.
</p>

<p>
If the system variable "timeout" or "mtimeout" is greater than zero, the timeout occurs when &lt;timeout&gt;.&lt;mtimeout&gt; seconds have passed. If the timeout is less than or equal to zero, the timeout never occurs.
</p>

<p>
These commands return one of the following values in the system variable "result":
</p>

<table>
 <tr>
  <th>Value</th>
  <th>Meaning</th>
 </tr>
 <tr>
  <td>0</td>
  <td>Timeout. No string has received.</td>
 </tr>
 <tr>
  <td>1</td>
  <td>&lt;string1&gt; has received.</td>
 </tr>
 <tr>
  <td>2</td>
  <td>&lt;string2&gt; has received.</td>
 </tr>
 <tr>
  <td>n</td>
  <td>&lt;stringn&gt; has received. n=1..10.</td>
 </tr>
</table>

<p>
NOTICE: The <a href="../../setup/teraterm-ini.html#Wait4allMacroCommand">Wait4allMacroCommand</a> entry in the teraterm.ini file must be "on" to use this macro command. Rarely, the macro command does not work well.
</p>

<h2>Example</h2>

<pre class="macro-example">
; Terminal1
pause 3000
end
</pre>

<pre class="macro-example">
; Terminal2
pause 3000
end
</pre>

<pre class="macro-example">
; Terminal3
wait4all 'message'
</pre>

</body>
</html>