タイミングの問題

この章では、アクションの処理に関係するタイミングの問題についていくつか説明し、 これらの問題に対処するために使用できるリソースについて説明します。

マクロのタイミングおよび遅延特性

このセクションでは、HATS マクロのタイミング・パラメーターをマクロのスクリプト・レベルで説明します。例えば、HATS Toolkit グラフィカル・ユーザー・インターフェース (マクロ・エディターなど) のさまざまな場所からのマクロ実行のタイミングに影響を与える方法は複数ありますが、ここでの説明は、マクロ自身の XML スクリプト内で実行されるアクションの結果について扱うもので、スクリプト内にアクションが配置されるさまざまな方法 (マクロ・エディターのタブなど) については扱いません。

いくつかのタイミング・パラメーターがマクロ実行に影響します。 大半のタイミング・パラメーターは、マクロ実行のさまざまな部分で遅延を制御します。 これによって、ホストの応答時間およびその他の変数が予測不能な環境において、マクロが回復力を持ち、堅固な状態で正しく作動することができます。 マクロに遅延を追加する最も一般的な理由は、ホストから入ってくる画面がマクロによって処理される前に、完全に到着するようにするためです。遅延が扱う画面に十分な追加説明 (例えば、画面のいろいろな部分の文字ストリングの検索など) が追加されている場合、この遅延はたいていの場合減少したり、まったく回避できます。

HATS マクロでは、エレメントと、エレメントを変更する属性があります (属性はパラメーターともいいます)。エレメントは左および右不等号括弧タグでフレームを付けられており、属性は通常、エレメントのタグに含まれています。例えば次の例では、画面エレメントと、変更する pause 属性がついています。

<screen pause=15000>

この章では、以下のエレメントおよび属性を扱います。

各エレメントおよび属性の役割

<HAScript> エレメントの pausetime 属性は以下の 2 つの事柄を制御します。

  1. 画面のアクション内で定義された大半の <prompt> および <insert> エレメントの後に発生する pausetimevalue /2 の遅延 (ミリ秒)
  2. (ほとんどの画面に対して) 一つの画面のすべてのアクションが実行された後に発生する pausetimevalue の一回限りの遅延 (ミリ秒)

pausetimevalue /2 および pausetimevalue の遅延がどこのどの画面で実行されているかについては、以下でさらに詳しく説明します。pausetimevalue のデフォルト値は、(pausetime 属性が明示的に定義されていない場合) 300 ミリ秒です。

pause 属性 (<pause> エレメントと混同しないこと) は、pausetime 属性をオーバーライドします。正確には、pause 属性がエレメント内で定義されると、マクロの <HAScript> エレメント内で (明示的またはデフォルトで) 定義された pausetime 属性を、その画面でのみオーバーライドするために使用されます。つまり、ある画面で pause 属性が定義されると、pausetime 属性は無視され、その <screen> エレメントの処理中に発生するあらゆる pausetime 関連の遅延を計算するのに、画面の pause 属性の値が使用されるということです。pause 属性および pausetime 属性は、<pause> エレメントの処理に影響されず、また影響も与えません。

<pause> エレメントは、明示的な遅延を画面のアクションの処理に挿入するために使用します。1 つ以上の <pause> エレメントは、画面の <actions> エレメントで定義された他のアクションの前後、およびそのアクション間に配置できます。 pause 属性および pausetime 属性は、<pause> エレメントの処理に影響されず、また影響も与えません。

<HAScript> エレメントの ignorepauseforenhancedtn 属性を true に設定すると、コンテンション解消環境でセッションが実行されている場合、マクロの実行中にマクロ・ランタイムは一時停止アクション (<pause> エレメント) をスキップします。この属性の使用法についての追加情報は、ignorepauseforenhancedtn=true/falseを参照してください。

<pause> エレメントの ignorepauseoverrideforenhancedtn 属性を特定の <pause> エレメント内で「true」に設定すると、<HAScript> エレメント内で ignorepauseforenhancedtn 属性が true に設定されていても、マクロ・ランタイムはその <pause> エレメントを処理します (指定されたミリ秒数のみ待機します)。この属性の使用法についての追加情報は、ignorepauseoverrideforenhancedtn=true/falseを参照してください。

<HAScript> エレメントの delayifnotenhancedtn 属性 をゼロ以外の値に設定すると、オペレーター情報域が変更されたという通知を マクロ・ランタイムが受け取ったときは常に、マクロ・ランタイムは指定された ミリ秒数のみ自動的に一時停止します。 この属性は、コンテンション解消環境または非コンテンション解消環境の 両方で同じマクロを正常に実行させるのに役立ちます。この属性の使用法について詳しくは、delayifnotenhancedtn=(ミリ秒)を 参照してください。

HATS マクロ処理エンジンがこれらのタイミング・エレメントと属性を使用する方法

非終了画面の場合 (exitscreen 属性は「false」に設定)、pausetimevalue の遅延が実行されるのは、画面のアクションがすべて実行された後で、次の画面の登録または認識が開始する前です。pause 属性が画面に定義されている場合、アクション後の遅延について、pausetime の値の代わりに pause の値が使用されます。

終了画面として定義されているマクロ画面の場合 (exitscreen 属性は「true」に設定)、pausetime 属性 (およびその終了画面に定義されている pause 属性) は実質的に無視され、すべての画面のアクションが完了した後に自動的に実行される追加の遅延はありません。これによって、マクロ・エンジンはマクロの最終画面までナビゲートすると、遅延を追加しません。

さらに、すべてのマクロ画面について、画面の最後のアクションでない <prompt> または <insert> の後、pausetimevalue /2 の時間、マクロはスリープ状態になります。

例えば、図 21 で示すように、pausetime="1000" で、他の pause 属性が画面に定義されていない場合、マクロは最初のアクション (prompt) の後に 500 ミリ秒、4 番目のアクションの後に 500 ミリ秒、そして (現在の画面が終了画面でない場合) すべてのアクションが実行された後に 1000 ミリ秒の、合計 2000 ミリ秒の間スリープ状態になります。

図 21. pausetimevalue の例 1
<actions>
       <prompt...
       <extract...
       <extract...
       <prompt...
       <insert...
</actions>

マクロ内で、<pause> エレメントはどこに配置されていてもインラインで実行され、pausetime 属性または pause 属性の設定でオーバーライドされませんが、<HAScript> エレメントの ignorepauseforenhancedtn 属性が「true」に設定されている場合、この属性でオーバーライドされることがあります。

上の例を拡張して、図 22 で示すように、pausetime="1000" で、他の pause 属性が画面に定義されていない場合、マクロは最初のアクション (prompt) の後に 500 ミリ秒、4 番目のアクションの後に 500 ミリ秒、5 番目のアクション (insert) の後に 500 ミリ秒、6 番目のアクション (<pause> エレメント) の後に 150 ミリ秒、そして (現在の画面が終了画面でない場合) すべてのアクションが実行された後に 1000 ミリ秒の、合計 2650 ミリ秒の間スリープ状態になります。

図 22. pausetimevalue の例 2
<actions>
       <prompt...
       <extract...
       <extract...
       <prompt...
       <insert...
       <pause value="150"/>
</actions>

これが終了画面の場合、合計スリープ時間は 1650 ミリ秒です。また、<HAScript> エレメントの ignorepauseforenhancedtn 属性と、<pause> エレメントの ignorepauseoverrideforenhancedtn 属性が設定されている場合、この例の明示的な <pause> エレメントが実行されても無視されても、これらの属性は有効になります。

画面のアクションの完了後に発生するもの

マクロで画面のすべてのアクションが処理し終わった後 (pausetime または pause 属性値に基づくすべてのアクションの後のスリープも含む)、nextscreen が登録され、タイマー (タイムアウト・クロック) が開始されます。マクロは登録時に画面の認識を試行し、画面が何も認識されない場合、nextscreen の時間だけ反復認識処理を開始します。これはホストから入ってくるデータによって生成された PSEVENT および OIAEVENT によってトリガーされます。PSEVENT または OIAEVENT がホストから到着する度に、マクロは nextscreen の認識を再度試行します。

画面認識処理は、着信する画面データの認識の試行を継続します。成功する前に何度か失敗することがあります (これらの失敗についてメッセージはログに記録されません)。マクロのタイムアウト・パラメーターは、それぞれの画面認識処理 (マクロ全体ではない) が、着信する画面の認識を試行する時間の上限を設定します。画面認識エンジンは「使用中」のループに入っていないことに注意してください。エンジンは、着信する PSEVENT および OIAEVENT の発生によってトリガーされるまで待機して、それぞれの追加比較を実施します。画面を認識する前にタイムアウト値を超えた場合、画面認識は失敗します。画面が認識されると、タイマーは停止します。

マクロ・エンジン処理の高水準なテキスト・フロー

  1. ScreenX が認識されます。
  2. ScreenX アクションが完了します。アクションが <prompt> または <insert> で、アクションのセットの最後のアクションでない場合、各アクションの後に pausetimevalue /2 (または pauseattributevalue /2) が追加されることに注意してください。
  3. 現在の画面が終了画面の場合、マクロの実行がここで停止します。
  4. ScreenX pausetimevalue 遅延(pausetime 属性によって設定されるか、この画面のローカルの pause 属性によってオーバーライドされる遅延) が完了します。
  5. nextscreens を登録します。
  6. nextscreens のタイムアウト・クロックを開始します。
  7. nextscreens の認識処理がループし、各 PSEVENT または OIAEVENT に基づいて新しい認識を実行します。PSEVENT または OIAEVENT の到着は、コンテンション解消がアクティブな場合、これによって制御されるか影響を受けます。
  8. nextscreen が認識され、この場合、タイムアウト・タイマーが停止します。 処理はシーケンスの先頭に戻って再度開始するか、またはタイムアウト・タイマー (<HAScript> エレメントの timeout 属性) の有効期限が切れて、マクロがタイムアウト・エラーで終了します。

アクション後の一時停止

ここでは、前のアクションに未完了の副次作用があるために、 アクションが期待どおりに実行されないシナリオについて説明します。

次の 2 つの属性を使用して、実行時にアクション後の一時停止を追加できます。

アクションの処理速度

マクロ・ランタイムは人間のユーザーよりはるかに迅速にアクションを 実行するので、マクロの再生中に予測しない問題が発生し、 アクションが予想通りに実行されない可能性があります。 この原因は、前のアクションへの依存関係が生じることです。

アプリケーション画面を切り替えるキー・ストロークを例に取ります。 アプリケーション画面がすでに切り替わっていることを 後続のアクションが予期しているにもかかわらず、実際には アプリケーション画面がまだ更新の途中である場合、後続のアクションは失敗します。

マクロ・ランタイムがそれぞれのアクションを前のアクションの直後に 実行すると、他の状況でアクション間の時間依存エラーが発生します。

pausetime 属性

<HAScript> エレメントの pausetime 属性は、 次のようにマクロ・ランタイムが待機する時間を指定します。

HATS バージョン 5 までは、pausetime 属性は、 入力アクションとプロンプト・アクションの後のみでなく、あらゆるタイプのアクション後の一時停止としてインプリメントされました。現在では、次のように インプリメントされます。

デフォルトでは、pausetime 属性は使用可能になっていて、タイムアウト値は 300 ミリ秒に設定されています。このため、マクロ・ランタイムはデフォルトで次のことを行います。

pausetime 属性はすべてのマクロ画面に影響を与えることに注意してください。このため、この 1 項目の設定により、問題がある 可能性のあるマクロ画面をそれぞれ変更しなくても、マクロ全体でタイミング・エラーを回避できます。

pause 属性

特定のマクロ画面のアクション間の一時停止を延長または短縮する場合、またはアクション間の一時停止が重要なマクロ画面が数個のみの場合には、<screen> エレメントの pause 属性を使用できます。

デフォルトでは、この属性は指定されていません。

マクロ画面に対してこの属性を指定すると、マクロ・ランタイムはこの特定のマクロ画面の「アクション間の一時停止」に、指定されたミリ秒数を使用します。

例えば、ScreenA の pause 属性を 500 ミリ秒に設定した場合、マクロ・ランタイムは、ScreenA 内で最後のアクションを除くそれぞれの入力アクションとプロンプト・アクションの後に 250 ミリ秒間待ち、ScreenA の最後のアクションの後に 500 ミリ秒間待ちます。

<screen> エレメントの pause 属性を指定したマクロ画面を マクロ・ランタイムが処理する際には、<HAScript> エレメントの pausetime 属性の設定が無視され、pause 属性の値のみが使用されます。

特定のアクションの後に一時停止を追加する

マクロ画面内で特定のアクションの後に追加の一時停止が必要な場合は、 そのアクションの後に一時停止アクションを追加できます。 一時停止アクションに指定した待機は、pausetime 属性または pause 属性によって発生するすべての待機に加算されます。

画面の完了

次のマクロ画面の認識が早すぎる

ホストが新しいアプリケーション画面の表示を完全に終了する前に、 マクロ・ランタイムが ScreenB のアクションの処理を開始するという バグが、マクロ画面 ScreenB にあるとします。 このタイミングの異常が問題になる状況はほとんどないかも しれませんが、例えば ScreenB の最初のアクションが抽出アクションであり、 マクロ・ランタイムがこのアクションによって アプリケーション画面の行 15 と 16 からデータを読み取るとします。 ホストが新規データを行 15 から 16 に すべて書き込む時間を待たずに、マクロ・ランタイムが このアクションを実行したとします。

この問題を分析すると、次のことが確認されます。

要約すれば、このタイミングの問題が起こった結果、ホストが行 15 と 16 の更新を完了する前に、マクロ・ランタイムが新しい アプリケーション画面の行 15 と 16 を読み取りました。

原因: 非拡張 TN3270 プロトコル

この問題が発生した理由は、非拡張 TN3270 プロトコル に、ホスト・アプリケーションの画面が完了したことを、ホストがクライアントに 通知する手段が組み込まれていないことです (TN3270 は、文字指向の接続で ある Telnet を基礎として、画面指向のプロトコルである 3270 データ・ストリーム をインプリメントしたものです)。したがって、ホストはいくつかのデータ・ブロックをクライアントに送信できず、アプリケーション画面が完了してユーザーはデータを入力できるようになったことを示すメッセージを出すこともできません。しかし、それぞれのブロックが着信するとき、 このアプリケーション画面の最後のブロックであるかどうかの指示はありません。 クライアントの視点から見ると、次のようなイベントが発生します。

  1. コマンドとデータのブロックが着信する。クライアントは、入力禁止標識を設定し、ブロックを処理して、新しいデータをホスト端末の指定部分に表示する。その後、クライアントは入力禁止標識をクリアし、待機する。
  2. 30 ミリ秒が経過する。
  3. 別のコマンドとデータのブロックが着信する。クライアントは、前の ステップ 1 と同じようにブロックを処理する。 このブロックにより、画面の別の部分が更新される。 クライアントは待機する。
  4. 50 ミリ秒が経過する。

ホストが新しいホスト・アプリケーション・データ画面を完全に 表示するまで、このプロセスは継続します。 クライアントは、ホスト・アプリケーションの画面が完了したかどうか 分からない状態で待機し続けます (詳しくは、マクロ・ランタイムによるマクロ画面の処理方法を参照してください)。

このプロセスが、人間のオペレーターにとって問題になることはありません。

ただし、このプロセスは、マクロ・ランタイムにとっては画面認識中に 問題になります。マクロ・ランタイムは、画面認識中に画面が更新されるたびおよび OIA イベントが発生するたび (繰り返し画面評価を参照) に、 アプリケーション画面と一致する有効な次のマクロ画面を 検索することに留意してください。 このため、マクロ・ランタイムは画面が完全に更新される前に一致を検出する 可能性があります。例えば、アプリケーション画面の行 3 に "ISPF Primary Option Menu" という文字が あるときに認識が発生するように、ストリング記述子が指示しているとします。 ホストが行 3 を更新してこれらの文字を表示したときに、 マクロ・ランタイムは一致が発生したと判断しますが、ホストが アプリケーション画面の残りの更新を完了したかどうかは考慮しません。

早期マクロ画面認識のためのソリューション

この問題の解決法は 3 つあります。

これらの解決策について、以下のサブセクションで説明します。

記述子の追加

この方法は場合によっては機能しますが、不便で信頼性がありません。 ScreenB の説明部分に十分な記述子を追加することにより、 アプリケーション画面の重要な部分が更新されるまで、マクロ・ランタイム が ScreenB を認識しないようにします。

入力アクションの後に遅延を挿入する

セッションが通常の TN3270 セッションである場合、 またはコンテンション解消機能を使用しない TN3270E セッションである 場合には、遅延の挿入が最適な解決策です。 つまり、入力アクション (この例では ScreenA) によって ホストが新しいアプリケーション画面を送信した後、 数百ミリ秒以上の一時停止を挿入します。 この遅延により、マクロ・ランタイムが次のマクロ画面 (ScreenB) の アクションの処理を開始する前に、ホストがアプリケーション画面を更新する ための十分な時間を取ることができます。

このシナリオで、入力アクションの後に一時停止を挿入する 方法はいくつかあります。

通常の TN3270 セッションと、コンテンション解消機能を使用可能に した TN3270E セッションの両方でマクロを実行する必要がある場合は、XML マクロ言語 に備わっているいくつかの属性が役立ちます。画面の完了に関係する属性を参照してください。

TN3270E のコンテンション解消機能の使用

TN3270E (拡張) は、セッションが接続する LU または LU プールを ユーザーが指定できるようにした TN3270 プロトコルの拡張形式です。 また、サーバーに ASCII モードで接続するため (例えば、ファイアウォールに ログオンするため) のネットワーク仮想端末装置 (NVT) プロトコル もサポートしています。

コンテンション解消モードは TN3270E のオプション機能で、TN3270E サーバー のすべてではなく一部がこの機能をサポートしています。 この機能は、ホストがアプリケーション画面の更新を完了したかどうか クライアントが認識できないという問題を解決します。 クライアントが TN3270E セッションを実行していて、 コンテンション解消をサポートするサーバーに接続している場合は、 ホストがアプリケーション画面の更新を完了するまで、 マクロ・ランタイムは新しいマクロ画面を認識しません。

画面の完了に関係する属性

Host On-Demand は、以下の両方の環境でマクロの単一バージョンを サポートする際にマクロ開発者が経験する問題に対処するために、3 つの エレメント属性を備えています。

これらの属性は、ソース表示を使用して追加する必要があります。

ignorepauseforenhancedtn=true/false

<HAScript> エレメントの ignorepauseforenhancedtn 属性を true に設定すると、コンテンションを解消する環境でセッションが実行されている場合、マクロの実行中にマクロ・ランタイムは一時停止アクション (<pause> エレメント) をスキップします。コンテンションを解消しない環境で実行するためのマクロを開発し (一時停止アクション を挿入)、コンテンションを解消する環境でもそのマクロを不要な遅延を 入れずに (一時停止アクションを無視して) 実行する必要が生じた場合には、 この属性を使用できます。

この属性を true に設定すると、マクロ・ランタイムは コンテンションを解消しない環境では一時停止アクションを処理 しますが (指定されたミリ秒数だけ待つ)、コンテンションを解消する環境では 一時停止アクションを無視します。

ただし、この属性を true に設定すると、マクロ・ランタイムは (アプリケーション画面を更新する時間を取るために挿入された 一時停止だけでなく)、マクロ内の一時停止アクション (<pause> エレメント) をすべてスキップ します。 次のサブセクションでは、この 2 次的な問題に対処します。

ignorepauseoverrideforenhancedtn=true/false

<pause> エレメントの ignorepauseoverrideforenhancedtn 属性を特定の <pause> エレメント内で true に設定すると、<HAScript> エレメント内で ignorepauseforenhancedtn 属性が true に設定されていても、マクロ・ランタイムはその <pause> エレメントを処理します (指定された ミリ秒数のみ待ちます)。

コンテンションを解消する環境で <HAScript> エレメントの ignorepauseforenhancedtn 属性を true に設定した場合でも、<pause> エレメントをスキップせずに常に実行する場合は、<pause> エレメント内でこの属性を true に設定します。

delayifnotenhancedtn=(ミリ秒)

<HAScript> エレメントの delayifnotenhancedtn 属性をゼロ以外の値に設定すると、OIA (オペレーター情報域) が変更されたという通知をマクロ・ランタイムが受け取ったときに、マクロ・ランタイムは指定された ミリ秒数のみ自動的に一時停止します。

コンテンションを解消する環境 (一時停止アクションを 挿入する必要がない) でマクロを開発し、コンテンションを解消しない環境 (アプリケーション画面 を完了する時間を取るために、マクロ画面に一時停止アクションが必要になる場合が ある) でもそのマクロを実行する必要が生じた場合には、この属性を使用できます。

この属性を true に設定した場合、コンテンションを解消しない環境で マクロを実行すると、OIA が変更されたという通知を受け取るたびに、 マクロ・ランタイムは指定されたミリ秒数だけ一時停止を挿入します。 例えば、200 ミリ秒の一時停止を指定すると、マクロ・ランタイムは OIA が 変更されるたびに 200 ミリ秒間待ちます。

OIA に対する変更の通知があるたびにマクロ・ランタイムが一時停止することを、要約的に累積する効果により、マクロ・ランタイムが新しいマクロ画面のアクションの 処理を開始する前に、アプリケーション画面が完了します。マクロ・ランタイムは、コンテンションを解消しない環境でセッションが 実行されていることを検出したときにのみ、これらの余分の一時停止を挿入します。

この属性の制限は、マクロ・ランタイムがこれらの余分の一時停止を (画面の更新が問題になっている画面の 処理中だけでなく)、すべての画面の処理中に追加することです。 ただし、余分に費やされる待ち時間は少しです。 また、より重要な点として、この属性を使用すれば コンテンションを解消しない環境にマクロを迅速に適応させることが できます。個々の画面をテストして、画面更新の問題があるそれぞれの 画面に一時停止アクションを挿入する必要はありません。