マクロ・ランタイムによるマクロ画面の処理方法で説明されているとおり、マクロ・ランタイムは通常、現行マクロ画面の <nextscreens> エレメント内を探すことにより、処理される次のマクロ画面候補となるマクロ画面の名前を見つけます。つまり、マクロ画面自体の中に、次の処理対象として有効なマクロ画面の リストが含まれています エントリー画面と一時画面は例外です。
エントリー画面、終了画面、および一時画面の設定を 使用して、マクロ・ランタイムが特別な方法で処理するマクロ画面に マークを付けることができます。ソース表示では、これらの設定値は <screen> エレメントの属性として表示されます。
図 1 では、entryscreen、exitscreen、および transient の 3 つの属性が Screen1 の <screen> エレメント にあることが分かります。
これらの設定を行う場所については、VME を使用する場合は「一般」タブを、AME を使用する場合は画面タブを参照してください。
マクロの実行時に最初に処理される画面の 1 つとして扱うマクロ画面を指定するには、画面をエントリー画面としてマークを付けます。ただ 1 つのマクロ画面、 または複数のマクロ画面を、エントリー画面 としてマークを付けることができます。
マクロの再生が開始されると、マクロ・ランタイムはマクロ・スクリプトを 検索し、エントリー画面として指定されたマクロ画面すべてを 検出します。その後、マクロ・ランタイムはこれらのエントリー・マクロ画面の 名前を有効な次画面のランタイム・リストに追加します。さらに、マクロ・ランタイムは、リストにある画面のいずれかと現行ホスト端末の一致を通常の方法で検索します。
エントリー・マクロ画面のいずれかとホスト端末の一致が マクロ・ランタイムによって検出されると、そのマクロ画面が 最初に処理されるマクロ画面になります。最初のマクロ画面のアクションを実行する前に、 マクロ・ランタイムは、有効な次画面のランタイム・リストから エントリー・マクロ画面の名前を除去します。
エントリー画面は、マクロ・スクリプト内での 登場順に評価されます。同じマクロに複数のエントリー画面がある状況の 1 つは、 ホスト・アプリケーションがアプリケーション画面 A を開始し、 次にアプリケーション画面 B、その次にアプリケーション画面 C と いったように、一連のアプリケーション画面を次々に開始するときです。 例えば、画面 A はログオン画面、画面 B は複数の サポート・プロセスを開始する画面、画面 C は アプリケーションの実際の初期画面などです。
この状況で、ユーザーがアプリケーション画面 A、B、または C のどれを 表示していてもマクロを実行できるようにすることができます。
画面をエントリー画面として指定しても、その画面はマクロ内で通常の画面と しても使用でき、他のマクロ画面の <nextscreens> リストに 含めることができます。
例えば、一連のメニュー選択項目のある、中央アプリケーション画面を持つ ホスト・アプリケーションがあるとします。 メニューの選択を行うたびに、アプリケーションはいくつかのアプリケーション画面 の処理を進め、元の中央アプリケーション画面に戻ります。
この状況で、マクロ ScreenA が中央アプリケーション画面に対応する マクロ画面であるとします。以下の両方が適用されます。
終了画面としてマクロ画面をマーク付けすると、マクロ・ランタイムはそのマクロ画面のアクションを実行した後、マクロを終了します。つまり、マクロ・ランタイムがアクションを実行した後、 画面認識に進む前にマクロ・ランタイムは 現行マクロ画面の終了画面標識が true に設定されているか どうか調べます。true に設定されている場合、マクロ・ランタイムはマクロを終了します (マクロ・ ランタイムは、出口画面の <nextscreens> エレメントを無視します)。
マクロの終了画面はいくつでも設定できます。複数の終了画面がある状況の 例をいくつか示します。
一時マクロ画面は、次の特性を持つアプリケーション画面の処理に使用されます。
このようなアプリケーション画面の一例は、ユーザーが無効なデータを 入力したときにアプリケーションが表示するエラー画面です。 このエラー画面が表示される回数は予測不能 (ユーザーが無効なデータを 入力したとき) であり、マクロ開発者としてこのエラー画面に対して行う必要が あるアクションは、エラー画面を消去してマクロを元どおり実行することだけです。
マクロ・ランタイムは、マクロの再生を準備する際に、 エントリー画面の名前を有効な次画面のランタイム・リストに 追加する時点で、一時画面として指定された すべてのマクロ画面 (あれば) の名前もリストの最後に 追加します。
一時画面は、エントリー画面としてのマークが付けられていない エントリー画面と見なされます。一時画面をエントリー画面として選択すると、 そのアクションが実行され、その後マクロはエントリー画面の すべてと一時画面のすべてを検査して、次に一致する 画面を決定します。
これらの一時画面のリストは、マクロの再生全体を通して、 有効な次画面のランタイム・リストに残ります。 マクロ・ランタイムが新しい候補マクロ画面の名前を (現行マクロ画面の <nextscreens> エレメントから) リストに追加するとき、 マクロ・ランタイムはこれらの新しい候補名を一時画面の名前の前に追加するので、 一時画面の名前は必ずリストの最後にあります。
マクロ・ランタイムが画面認識を実行するとき、 リストにあるすべての名前のマクロ画面を通常の方法で評価します。 リストに名前がある候補マクロ画面から、アプリケーション画面との 一致をマクロ・ランタイムが検出できない場合、マクロ・ランタイムは リストを順に進めて、アプリケーション画面のリストに指定されたいずれかの一時マクロ画面と の一致を検索します。
現行アプリケーション画面といずれかの一時マクロ画面との一致を検出した場合、 マクロ・ランタイムはリストから名前を除去しません。 代わりに、マクロ・ランタイムは一時マクロ画面のアクション (予期しないアプリケーション画面 を消去する) を実行し、予期しないアプリケーション画面が発生したときに 行っていた画面認識処理に戻ります。
マクロ・ランタイムが画面認識を行っていて、有効な次画面のリスト に 3 つのマクロ画面の名前があるとします。これらの画面は、ScreenB と ScreenD (候補画面の名前)、および ScreenR (一時画面の名前) です。 マクロ・ランタイムは次のステップを実行します。
ここでは、現行アプリケーション画面と有効な次画面のリストにある 画面の一致が見つからないために、マクロ・ランタイムが先に進むことが できないシナリオについて説明します。 次の 2 つのフィールドを使用して、タイムアウト値を設定できます。 タイムアウトになる前に画面認識が成功しない場合、マクロは終了します。
マクロ・ランタイムは、マクロ画面の <actions> エレメント内のすべてのアクションを実行した後、新しいアプリケーション画面 (マクロ・ランタイムによるマクロ画面の処理方法 を参照) に対して、有効な次画面のリストにある画面の 1 つの突き合わせを試みます。
場合によっては、予測できない事情のために、 有効な次画面のリストにあるマクロ画面とアプリケーション画面の一致を、 マクロ・ランタイムが検出できないことがあります。 例えば、予測しなかったアプリケーション画面にナビゲートする入力シーケンスをユーザーが入力する場合があります。また、システム・プログラマーがアプリケーション画面を変更したために、 そのアプリケーション画面が、対応するマクロ画面の <description> エレメント内の記述と一致しなくなる こともあります。
こうしたシナリオが発生すると、マクロ・ランタイムが 一致の検出を試行して失敗し続けている間、マクロはハング状態になります。
<HAScript> エレメントの timeout 属性は、VME の「画面間のタイムアウト」設定を使用して設定できます。「一般」タブを参照してください。AME の場合は、図 61を参照してください。この属性は、画面認識のタイムアウト値を指定します。デフォルトでは、指定された値はマクロ内の各マクロ画面すべてに適用されます。ただし、<nextscreens> エレメントの timeout 属性を使用すると、特定のマクロ画面に対する値を変更できます (<nextscreens> エレメントの timeout 属性を参照)。
マクロ・ランタイムは、画面認識の実行の開始時には常に、 マクロ全体に対してタイムアウト値が設定されているかどうかを、または次の画面のマクロ画面のリストに対してタイムアウト値が設定されているかどうかを判断するためにチェックします。タイムアウト値が設定されている場合、マクロ・ランタイムは、 タイムアウト値に指定されているミリ秒数にタイマーを設定します。 マクロ・ランタイムが画面認識を完了する前にタイマーが満了した 場合、マクロ・ランタイムはマクロを終了します。ブラウザーにエラー・ページが表示され、サーバー・コンソールに次のようなメッセージが表示されます。
Macro timed out: (Macro=ispf_ex2, Screen=screen_address_type)
このメッセージには、マクロの名前と、タイムアウトが発生したときに 処理していた画面の名前が表示されていることに注意してください。例えば、このメッセージに指定されている画面が ScreenA ならば、 マクロ・ランタイムはすでに ScreenA のアクションをすべて実行済みで、ScreenA の 有効な次画面リストにあるマクロ画面とアプリケーション画面の一致を検索して いました。
マクロがホスト端末で再生されている場合は、次のメッセージが表示されます。
The host terminal does not match any expected screens.
指定される場合、デフォルトのタイムアウト値は 60000 ミリ秒 (60 秒) に設定されます。
<nextscreens> エレメントの timeout 属性は、画面認識のタイムアウト値を指定します。この属性は、VME ではソース・タブを使用することにより、および AME では「タイムアウト」フィールドを使用することにより、設定できます。図 73を参照してください。この値がゼロ以外の場合、マクロ・ランタイムは、 <HAScript> エレメントの timeout 属性に設定されている値を使用しないで、この値を、有効な次の画面の現行のリストのマクロ画面の画面認識に対するランタイム値 (ミリ秒単位) として使用します。
マクロ・ランタイムが画面認識を完了する前にタイマーが満了した 場合、マクロ・ランタイムは図 12 の メッセージを表示します。
認識限界を設定すると、 マクロ・ランタイムが特定のマクロ画面を処理する回数が多すぎる場合に、 何らかのアクションを行うことができます。 マクロ・ランタイムが同じマクロ画面を処理する回数が多い場合 (100 など)、 その理由はおそらく、マクロ内でエラーが発生して、 マクロがエンドレス・ループから抜け出せなくなっているためです。
認識限界は、<screen> エレメントの開始タグ内の属性ではなく、<screen> エレメント 内でオプションとして指定できる別個のエレメント (<recolimit> エレメント) で す (<description>、<actions>、および <nextscreens> の各エレメント と同レベル)。
<recolimit> エレメントは、VME ではソース・タブを使用することにより、および AME では「認識限界の設定」チェック・ボックスと「エラーになる前の画面」入力フィールドを使用することにより、追加できます。画面タブを参照してください。
認識限界に達すると、マクロ・ランタイムはエラー・メッセージを出して マクロを終了するか (これがデフォルト・アクションです)、 指定した別のマクロ画面の処理を開始します。
認識限界は 1 つの特定の画面に適用され、デフォルトでは認識限界は指定されないことに気がつきます。認識限界は任意のマクロ画面に対して指定でき、 認識限界を組み込むそれぞれのマクロ画面ごとに、指定する認識限界の値は 同じでも異なっていても構いません。
マクロ・ランタイムは、<recolimit> エレメントを含むそれぞれの マクロ画面ごとに認識カウントを記録します。 マクロの再生が開始されると、すべてのマクロ画面の認識カウントが 0 に なります。
マクロに ScreenB という名前のマクロ画面が含まれていて、ScreenB に 認識限界 100 を指定した <recolimit> エレメントがあるとします。 マクロ・ランタイムが ScreenB を認識するたびに (つまり、 マクロ・ランタイムが ScreenB を次に処理するマクロ画面として選択するたびに)、 マクロ・ランタイムは次のステップを実行します。
認識限界に達したときのデフォルト・アクションでは、マクロが強制終了され、ブラウザーにエラー・ページが表示されます。 次のエラー・メッセージがサーバー・コンソールに表示されます。
認識限界に達しましたが、goto 画面が提供されていません。マクロを終了します。 (Recolimit reached, but goto screen not provided, macro terminating.)
マクロ・ランタイムに、認識限界に達したときのアクションとして別のマクロ画面への移動を行わせるには、ソース表示を使用して <recolimit> エレメントに goto 属性を追加し、この属性の値として移動先のマクロ画面の名前を指定する必要があります (<recolimit> エレメントを参照)。
goto 属性を使用すると、マクロ・ランタイムは マクロを終了せず、代わりに属性に指定されたマクロ画面の処理を開始します。
ターゲット・マクロ画面はどの目的にも使用できます。 考えられる用途には次のものがあります。