Tera Termで複数行受信！recvlnとwait活用術

Tera Termのrecvlnで複数行データを受信する基本

recvlnコマンドの役割と動作の仕組み

Tera Termマクロにおいて、ホストからの出力を1行ずつ読み取るために欠かせないのがrecvlnコマンドです。このコマンドは、接続先の機器から送られてくる文字列を「改行コード」が現れるまで待機し、受信した内容をシステム変数である「inputstr」に格納します。

基本的な動作としては、1行の受信が完了するとマクロの実行が次の行へ移ります。通信が途絶えたり、期待した改行がなかなか来なかったりする場合に備え、タイムアウト設定と組み合わせて使用するのが一般的です。特に、大量のログが出力されるサーバー操作や、設定値の確認において、特定の1行を正確にキャッチするための第一歩となる重要なコマンドと言えるでしょう。

受信データを変数に格納し活用する方法

受信したデータは、自動的にinputstrという変数に入りますが、この変数は「次の受信が発生すると中身が上書きされる」という性質を持っています。そのため、受信した内容を後で解析したり、ファイルに書き出したりしたい場合は、別のユーザー定義変数にコピーしておく必要があります。

例えば、strcopyコマンドを使用して他の変数に退避させたり、filewritelnを使用してログファイルに即座に書き出したりする処理がよく使われます。これにより、複数行にわたる複雑なデータであっても、1行ずつ確実に処理を進め、最終的に必要な情報だけを抽出するような高度なマクロが構築可能になります。

タイムアウト設定とresult変数の重要性

recvlnを使用する際に必ず意識すべきなのが、システム変数resultの値です。recvlnが正常に1行を受信できた場合、resultには「1」が格納されます。一方で、設定されたタイムアウト時間内に改行が受信できなかった場合は「0」が格納されます。

ここがポイント！
受信待ちでマクロがフリーズするのを防ぐため、必ず「timeout」変数を秒単位で設定しておきましょう。また、ループ処理の中でrecvlnを使う際は、if result=0 then breakのように記述して、異常時にループを抜ける仕組みを作ることが重要です。

recvlnとwaitを組み合わせた高度なデータ取得

特定の応答を待ってから受信を開始するフロー

単にデータを流し読みするだけでなく、特定のコマンドを実行した後の「結果だけ」を取得したい場合には、waitコマンドとの併用が効果的です。例えば、プロンプト記号（「#」や「>」など）をwaitで待ち、その直後にrecvlnを開始することで、余計なエコーバックや以前の出力を排除し、目的のデータから受信をスタートできます。

この流れを意識することで、マクロの動作が格段に安定します。闇雲にrecvlnを繰り返すのではなく、「きっかけ」をwaitで作るという考え方が、実戦的なマクロ開発のコツです。

同期モード（setsync）による確実なデータ取得

ネットワークの遅延や機器の処理速度によって、データが欠落したり、読み込みが追いつかなくなったりすることがあります。これを防ぐための強力な設定がsetsync 1です。

• setsync 1（同期モード）：マクロの各ステップが完了するのを待ってから次に進みます。
• setsync 0（非同期モード）：データの受信を待たずにマクロが先行して実行される可能性があります。

データ取得の確実性を高めたい場合は、取得処理の直前でsetsync 1を有効にし、処理が終わったらsetsync 0に戻すという手法が推奨されます。

複数の期待値に対応する条件分岐の作り方

waitコマンドの優れた点は、最大10個までの検索文字列を同時に指定できる点です。例えば、コマンドの実行結果が「OK」で終わるか「ERROR」で終わるか分からない場合、wait ‘OK’ ‘ERROR’と記述します。

この際、result変数には、何番目の文字列にヒットしたかの数値が入ります。1番目の’OK’ならresult=1、2番目の’ERROR’ならresult=2となります。これを利用して、正常終了時と異常終了時でその後のrecvlnの処理を分岐させることで、より柔軟な自動化プログラムが作成できます。

waitコマンドのよくある落とし穴と解決策

タイムアウトが短すぎる場合のトラブルと対策

waitコマンドで最も多いトラブルが、意図しないタイムアウトによるマクロの中断です。複雑な計算を行うコマンドや、大きなファイルの転送を伴う処理では、応答が返ってくるまでに数十秒かかることも珍しくありません。

デフォルトのタイムアウト設定が短いと、まだ処理中であるにもかかわらずマクロが「失敗」と判断してしまいます。処理内容に応じて、timeout = 60（60秒）のように、余裕を持った値をその都度設定し直す癖をつけましょう。

受信バッファのゴミが引き起こす誤作動の防ぎ方

マクロを実行する前に、以前の操作で受信したデータがTera Termのバッファに残っていることがあります。この「ゴミ」が残っていると、waitコマンドが過去の文字列に反応してしまい、現在実行中のコマンドの結果を待たずに次へ進んでしまうことがあります。

トラブル回避のテクニック
重要なwaitコマンドを呼び出す直前でflushrecvコマンドを実行してください。これにより受信バッファがクリアされ、正真正銘「今から届くデータ」だけを対象に待ち受けを行うことができます。

期待する文字列が完全一致しない時の確認ポイント

「waitで指定した文字列が画面に出ているのに反応しない」という場合は、隠れた文字コードを疑いましょう。特に、行末の改行コード（CRやLF）や、制御文字、エスケープシーケンスなどが文字列に含まれていると、見た目は一致していてもwaitはヒットしません。

解決策として、特定の単語（キーワード）のみをwaitに指定するか、正規表現は使えないものの、部分一致を狙った短い文字列を指定するのが定石です。また、ログをテキストエディタで開き、不可視文字が混入していないか確認するのも有効な手段です。

Tera Termのループ処理で自動化を実現

while文を用いた無限ループと終了条件の設定

複数行のデータをすべて取得するには、whileとendwhileによるループ処理が不可欠です。基本的には「while 1」で無限ループを作成し、その中でrecvlnを繰り返します。

ここで重要なのが「いつループを止めるか」という終了条件です。例えば、空行（inputstrが空）を受信したときや、特定のプロンプト文字列が現れたときにbreakコマンドを実行するように構成します。これがないと、マクロが永遠に終了しなくなってしまうため注意が必要です。

特定のキーワードが出現するまで読み込み続ける方法

特定のメッセージが表示されるまでログを監視し続けるようなケースでは、ループ内でstrscanコマンドを活用します。受信した各行に対して、特定のキーワードが含まれているかを検索し、見つかった場合にのみ次の処理へ進むといったロジックです。

例えば、「Finalizing…」という文字列が含まれる行を受信するまでrecvlnを回し続けることで、処理の完了を正確に検知できます。

配列変数（dim）を活用した大量データの整理

受信した各行のデータを、後でまとめて比較したい場合は、dimコマンドで配列変数を宣言しておくと便利です。

このようにデータを整理することで、特定の行だけを後から抽出してメッセージボックスに表示するなどの応用が可能になります。

recvln, wait, rebootコマンドの連携活用

サーバー再起動後の自動ログインとログ取得

サーバーの再起動（reboot）を伴うメンテナンスを自動化する場合、再起動コマンドを送った後に「通信が切れること」と「再び繋がること」をマクロでハンドリングする必要があります。

まずrebootを送信し、一旦unlinkやclosettで接続を閉じます。その後、一定時間おきにconnectを試み、接続が成功したらwaitでログインプロンプトを待ちます。この一連の流れにrecvlnを組み込むことで、起動直後のシステムログを自動的にキャプチャし、正常に起動したかを自動判定する仕組みが作れます。

起動シーケンス中の特定メッセージを補足する

OSやネットワーク機器の起動中には、通常運用時には見られない重要な起動ログ（ブートメッセージ）が流れます。これを補足するには、接続直後からsetsync 1で同期モードに入り、高速で流れるログをrecvlnで拾い続ける必要があります。

特に「Error」や「Fail」といった単語を監視するように設定しておけば、現場に立ち会うことなく、起動失敗の兆候を自動的に検知してログに残すことができます。

定期的なリブート試験とログの自動保存

システムの耐久テストなどで、100回連続でリブートを繰り返すといった過酷な試験も、マクロなら容易です。

自動化の黄金サイクル
「再起動送信」→「起動完了までwait」→「設定確認コマンド送信」→「recvlnで複数行の結果取得」→「ログファイル保存」というサイクルをループさせましょう。手作業では不可能な回数の試行を確実に行い、すべてのログを証跡として保存できるのがTera Termマクロ最大の強みです。

これらのテクニックを組み合わせることで、単純な作業から複雑な検証作業まで、あらゆるインフラ運用の効率を劇的に向上させることが可能になります。

Tera Termからのデータ取得を加速！AIで「受信」作業をスマートに

Tera Termを使った複数行受信や、waitコマンドとの組み合わせは、リモートサーバーからのデータ取得やログ解析において非常に強力な手法です。しかし、コマンドの正確な記述や、複雑な条件設定に頭を悩ませることもあるでしょう。そんな時こそ、AIをあなたの「秘書」や「優秀なアシスタント」として活用してみませんか？AIは、あなたが本来集中したい分析や判断といったコア業務に、より多くの時間とエネルギーを割けるよう、情報整理や作業の下準備を強力にサポートしてくれます。

【思考の整理】記事のテーマをAIで整理・優先順位付けするコツ

「recvln」や「wait」といったキーワードから、どのような情報をAIに整理してほしいかを具体的に指示することが重要です。「Tera Termのrecvlnコマンドで複数行データを受信する際の注意点と、waitコマンドとの効果的な使い分けについて、初心者にも分かりやすく解説するためのポイントを5つ挙げて」といった形で、出力してほしい内容の方向性を明確に伝えましょう。これにより、AIは記事の核となる部分を捉え、読者が理解しやすいように情報を整理するためのたたき台を提供してくれます。

また、AIに「waitコマンドが効かない場合の代替策」や「ループ処理による自動化のヒント」といった、より実践的な側面に焦点を当てて説明させることで、記事の網羅性を高めることができます。AIは、あなたが気づいていない視点や、関連性の高い情報を提示してくれる可能性があり、思考の幅を広げる手助けとなるでしょう。

【実践の下書き】そのまま使えるプロンプト例（ を使用）

AIに具体的な作業を依頼する際は、明確な指示を出すことが成果物を大きく左右します。例えば、以下のようなプロンプトは、記事の読者がTera Termでのデータ受信をよりスムーズに行えるようになるための「実践的なヒント」をAIに整理させるのに役立ちます。AIは、あなたの意図を汲み取り、具体的なコード例や注意点を盛り込んだ解説文の下書きを作成してくれます。

あなたはTera Termの通信スクリプト作成に詳しいアシスタントです。
以下の条件を満たす、recvlnとwaitコマンドを組み合わせたTera Termマクロのサンプルコードと、その解説を作成してください。

条件：
- サーバーから「login:」というプロンプトが表示されたら、ユーザー名を入力してEnterキーを押す。
- 次に「Password:」というプロンプトが表示されたら、パスワードを入力してEnterキーを押す。
- ログイン成功後、「Welcome!」というメッセージが表示されるまで最大30秒待機し、その後「show status」コマンドを実行して結果を受信する。
- waitコマンドがタイムアウトした場合のエラーハンドリングも簡潔に含めてください。
- マクロの各部分の動作を説明してください。

このように、具体的なシナリオと達成したい目標をAIに伝えることで、AIはあなたの要望に沿ったコードの雛形や、その丁寧な解説文を生成してくれます。生成された内容は、そのまま使用するのではなく、あなたの実際の環境や必要に応じて細かく調整するための出発点となります。

【品質の担保】AIの限界を伝え、人がどう微調整すべきかの知恵

AIはあくまで「アシスタント」であり、最終的な判断や責任はあなた自身にあります。AIが生成したコードや解説は、あくまで「たたき台」として捉え、必ずご自身の環境でテストし、意図した通りに動作するかを確認してください。特に、セキュリティに関わるパスワードの扱いなど、デリケートな部分はAIの提案を鵜呑みにせず、慎重に検討する必要があります。

AIは、未知の環境や特殊な設定、あるいは最新のソフトウェアの挙動には対応しきれない場合があります。生成された内容に疑問点や不自然な点があれば、躊躇なくAIに再質問したり、ご自身の知識や経験に基づいて修正を加えたりすることが、高品質な成果物へと繋がります。AIとの協働は、より洗練された作業を行うための「パートナーシップ」なのです。