macro/command/setsync.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=Shift_JIS">
  <title>setsync</title>
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="stylesheet" href="../../style.css" type="text/css">
</head>

<body>


<h1>setsync</h1>

<p>
同期モードを設定する。
</p>

<pre class="macro-syntax">
setsync &lt;sync flag&gt;
</pre>

<h2>解説</h2>

<p>
&lt;sync flag&gt; が0以外ならば同期通信モードに入る。<br>
&lt;sync flag&gt; が0ならば非同期通信モードに入る。
</p>

<p>
Tera Term はホストから受信した文字を MACRO へ転送する。<br>
MACRO はそれらの文字をバッファーに保存し、受信文字を処理するコマンド("<a href="wait.html">wait</a>" コマンド等)がバッファーから文字を取り出す。
</p>

<p>
MACRO は初期状態として非同期モードにいる。このモードでは、受信文字を処理するコマンドが長い間実行されない場合、または受信速度が早すぎる場合はバッファーがあふれる可能性がある。<br>
同期モードでは、バッファーは決してあふれない。バッファーがいっぱいになった場合、Tera Term はホストからの文字受信と MACRO への文字転送を停止する。バッファーに再び空きができると Tera Term は文字受信と転送を再開する。<br>
必要な時に限り同期モードに入り、必要でなくなったら非同期モードに戻るようにした方が良い。
</p>

<p>
複数行にわたる受信した文字を、一文字も失うことなく処理する、というような信頼性が要求されるマクロ処理の場合、同期モードに入る必要がある。<br>
しかし、同期モードでは Tera Term の文字受信速度が遅くなり、また受信文字を処理するコマンドが長い間実行されない場合は、Tera Term の文字受信が停止したままになってしまう。<br>
一方、単純なマクロ処理(例えば自動ログイン)ならば非同期モードでもほとんど問題なく動作する。この場合、バッファーサイズは十分大きく(4096バイト)、受信したすべての文字はバッファーがあふれる前にコマンドによって処理される。
<p>

<p>
バッファのクリアについては "<a href="flushrecv.html">flushrecv</a>" 参照。
</p>
<h2>例</h2>

<pre class="macro-example">
<code>; 同期モードに入る
setsync 1

; 非同期モードに入る
setsync 0
</code></pre>

</body>
</html>